Skip to main content

​
Overview

Before tokens can be distributed, recipients need to add their blockchain wallets. Wallets go through a verification process to ensure they are valid and owned by the recipient.

​
Wallet Lifecycle

​
Adding Wallets

Recipients can add wallets through the employee portal, or admins can add them on behalf of recipients. Required information:
  • Wallet address — The blockchain address
  • Network — Which blockchain (Ethereum, Solana, etc.)
  • Wallet type — Configured by the admin (e.g., “Hot Wallet”, “Custody”)
API: Use Add Wallet to add wallets programmatically, or Bulk Upload Wallets for multiple wallets.

​
Wallet Verification

Wallet verification uses test transactions to confirm the recipient controls the address.
1

Admin initiates test transaction

Go to the wallet management page and click Send Test Transaction for the wallet.
2

System sends a small amount

A configurable amount of tokens is sent to the wallet address. The recipient receives an email notification.
3

Recipient confirms receipt

The recipient logs in and confirms they received the test transaction.
4

Admin approves

The admin reviews and approves the verified wallet.
API: Use Send Test Transaction to initiate verification, then Approve Wallet Request to approve.

​
Managing Wallets

​
Wallet Distribution

Once wallets are verified and approved, configure how tokens are distributed across a recipient’s wallets.
1

Navigate to wallet distribution settings

Go to the recipient’s wallet configuration.
2

Set distribution ratios

Assign a percentage or fixed amount to each wallet. Ratios must total 100%.
3

Save

The distribution configuration applies to all future vestings for that recipient.
API: Use Configure Wallet Distribution for Grant or Set Token Wallet Distribution for programmatic configuration.

Wallet Verification API

Automate wallet verification via API

Token Distributions

Learn how distributions work after wallets are set up