“Push airdrop”, “Vesting airdrop” and “Time-bound airdrop” each have their own entry under Asset lifecycle in the Console sidebar. The entry opens a table of that add-on's airdrops, and each airdrop opens a read-only detail screen with its distribution, cap, recipients and recovery date. The Token distribution concept explains how the three airdrop types differ.
An add-on is a contract that your DALP system deploys from an add-on factory to work with its tokens: an airdrop, an offering, an XvP settlement, a vote, a trading venue, an escrow or a custody gateway. Every add-on opens at a Console address built from its factory address, and the same address opens the other add-on types, each on its own screen or as one overview card. Add-on types and where each opens lists them. A change that an add-on approval rule holds is decided on the custody gateway's Approvals tab or in Actions.
The “Push airdrop” page shows its table before any airdrop exists.
With no airdrop yet, the table reads “No data available yet”, under a “Search airdrops…” field with “Export” and “View”. Once airdrops exist, the columns are “Airdrop”, “Distributed”, “Recovery” and “Created”.
Steps
Open the add-on
Open the add-on type's entry under Asset lifecycle. The page title is the type's name, and the breadcrumb reads “Asset lifecycle”, then the type.
After the fixed entries, such as “Offerings” and “Venues”, the sidebar shows one entry for each airdrop add-on the system has, then Custody gateway. When the system has two add-ons of one type, each entry carries the add-on's own name.
Read the airdrops
The table lists the add-on's airdrops:
- The Airdrop column carries the airdrop's name with the symbol of the token it distributes.
- Distributed shows the amount sent so far, out of the cap when the airdrop has one.
- Recovery reads “Scheduled” once the airdrop's owner has scheduled a withdrawal, and “None” otherwise.
The withdrawal can run from the “Recovery available” time on the detail screen, and it takes only the tokens no recipient can still claim. On a vesting airdrop, it leaves the unclaimed part of every allocation whose vesting has started, and those recipients keep claiming. On a push airdrop, whose recipients do not claim, it takes the whole balance.
Search with Search airdrops…. Each row's menu offers “View details” and “Copy address”.
Open an airdrop
Select an airdrop row, or View details in its menu, to open the airdrop's detail screen. The header carries the airdrop's name and the date it was created, and reads “Scheduled” when a withdrawal is scheduled. A “Distribution” card lists the fields in Airdrop details.
The Console has no control that creates an airdrop or schedules its recovery. A holder of the Governance role on the token creates an airdrop by calling its factory contract's create directly, and the airdrop's owner schedules a recovery on the airdrop contract.
Read the other add-on types
The add-on address opens a different screen for each other type:
- An XvP settlement add-on shows the settlements table and Create XvP settlement. XvP settlement describes it, and its detail screen.
- An offering add-on shows the offerings table. An offering address takes you to the offering's operating screen when you operate the sale, and to its subscription view when you do not. Offerings describes the operating screen.
- A votes add-on redirects to Votes under “Wealth”.
- Any other add-on shows one Add-on overview card with the add-on's “Address”, “Type” and “Category”.
A vesting distribution created before withdrawal reserves were introduced keeps its whole balance reserved after its factory moves to the new implementation. Recipients can still claim, but owner recovery sends zero, even after all claims finish: the contract cannot reconstruct the older allocations from its records.
Airdrop details
The Distribution card on an airdrop's detail screen lists:
Add-on types and where each opens
The Console groups add-on types by category. Each name in the table is the label the Console shows.
The Console keeps the access manager and the governance timelock out of the sidebar. The access manager is an internal add-on that creates a dedicated access manager for an add-on such as a trading venue or the custody gateway. The factory list also holds token feature factories, such as Dividend yield or Permit, which add a feature you configure on the token, as Token features describes.
Troubleshooting
An add-on entry is missing from the sidebar
The airdrop entries show only to a System manager, an Asset manager, a Permission manager, an Owner, a Platform admin and a holder of the Governance role on an asset. The Custody gateway entry shows only to an Owner and a Platform admin. An airdrop type that the system never deployed shows greyed with the line “Push airdrop is not deployed”, so ask a System manager to deploy it in Factories.
An address shows This page does not exist
The address names an add-on or an instance the Console has no screen for. Add-ons other than airdrops, XvP settlements and offerings have no instance screen, so an instance address of one of them shows “This page does not exist”. Use the add-on's own entry instead, or the Add-on overview card at the add-on address.
A claim is refused during a corporate action
An airdrop that holds a token for claimants is frozen for that token from the record date of a corporate action that changes every holder's units by a ratio, such as a stock split, until the action's step lands. Claims in that window are refused with a message that names the token and the action. Claim again once the action has finished. After it, each claim pays its committed amount scaled by every action since the root was set. An airdrop counts as one holder, so a claim rounds down to the action's unit and is never lifted to one share.
API routes
The request and response fields of each route are in the v2 API reference.