Every Tempo feature in this section is in beta and available through the API only. To get access, contact your Customer Success Manager (CSM).
How it works
A virtual address is a normal 20-byte address with a fixed layout:masterIdidentifies the registered master wallet.- The 10-byte marker is how Tempo recognizes the address as virtual.
userTagis a value you choose, for example a customer ID. One master supports about 2.8 × 10^14 tags.
masterId and a userTag. Creating one needs no transaction and costs nothing.
Also keep in mind:
balanceOf(virtualAddress)is always 0. The balance shows on the master wallet.- Receive policies and compliance checks run against the master wallet.
- If you mint an LP position or another protocol-recorded asset to a virtual address, it can be stranded unless that protocol supports virtual addresses.
Register a vault account as a master wallet
Call the register endpoint with the vault account and the Tempo asset:202 with the wallet status PENDING_ACTIVATION. Call it again to check progress. Once the wallet is READY, the call returns 200.
Response
Receive deposits
Fireblocks credits a TIP-20 deposit to one of your virtual addresses to the master vault account. The transaction’sblockchainInfo tells you which virtual address received it:
userTag against your own records to credit the right customer.
Send to a virtual address
A virtual address is accepted as a destination like any other Tempo address. Use aONE_TIME_ADDRESS destination or a whitelisted address. You can’t send from a virtual address, because no key controls it. Always send from the master vault account.