Blockstream AMP is available as an API, allowing integrated into existing systems and providing an easy way to expose end users to the asset capabilities of the Liquid Network. Details of how to obtain an API access token and then use the API can be found in the Blockstream AMP API Tutorial.
The Issuer-Tracked Asset type doesn’t place any restrictions on the recipient and there is no need for the issuer to register users in advance. Ownership can be taken by anyone who receives the asset to their Blockstream Green wallet’s ‘Managed Assets’ account. Transfers of the asset between Blockstream Green users is tracked by Blockstream AMP using the user’s Blockstream Green Account ID (GAID). The issuer can view GAID balances for their asset, while the transactions remain private on the Liquid blockchain.
The Transfer-Restricted Asset type requires that the issuer registers the GAID of any potential owners within Blockstream AMP prior to the user being able to receive or transact it. This asset type can be used to issue and manage security tokens, amongst other things. This asset type also tracks and reports on ownership by GAID.
We’ve provided some Case Studies that help explain the different uses of Blockstream AMP.
Blockstream Green is available for both mobile and desktop. The Blockstream Green Development Kit (GDK) can be used if users want to programatically manage a wallet’s Blockstream AMP assets. Examples are provided that show how to use GDK with Python and also how to use GDK from the command line.
A brief overview of Blockstream AMP can also be found on the Blockstream website.
Features and Benefits¶
Issue, assign, and distribute security tokens and other assets to registered users/investors using the transfer restricted asset type.
Apply category-based transfer restrictions to registered users.
Enable granular control of transaction restrictions by connecting Blockstream AMP to your own authorization API.
Report on user balances, ownership and asset activities.
Track reissuance and burn of an asset’s circulating supply.
Simplify the registration of an asset with the Liquid Asset Registry, for integration into Blockstream Green, Blockstream Explorer, and other supporting applications.
Issuers can delegate the management of their user and assignment data to third parties.
Blacklist asset UTXOs to cover user key-loss scenarios.
Manage the assignment and distribution of security tokens as vesting shares and record external dividend payments.
Calculate reward scheme payouts to asset owners.
Track Liquid’s Issued Assets with no need for registered user records with the issuer tracked asset type.
Before reading in more detail about Blockstream AMP and the asset types it allows you to manage, you might find it useful to refer to some commonly-used terminology and the features enabled by the Liquid Network. These can be found at the bottom of this page and in the Liquid section of this site.
Blockstream AMP relies on Blockstream Green to act as a co-signer to asset transfers, and so it stores the necessary information to record relevant transfer details, such as amounts and destinations. This enables issuers to produce reports, such as ‘proof of transfer’ and ‘proof of balance’, to auditors or regulators. Blockstream AMP also provides API endpoints that allow issuers to view transfer history, asset activities, and ownership, at any given Liquid block height.
All distributions, reissuances, burns, and transfers of Liquid Blockstream AMP managed assets that are held by the issuer’s Liquid node must be done using the Blockstream AMP API. This ensures that asset UTXOs remain tracked through Blockstream AMP.
Transfer Override Functions¶
For transfer restricted assets, Blockstream AMP implements transfer restrictions through the use of ‘whitelist’ categories. This process involves creating a category, assigning it to an asset, and then assigning users to the same category, which makes them eligible to receive the asset. Using a category, or set of categories, to manage user eligibility will handle most common processes but occasionally, issuers will have transfer restrictions that require additional logic or need certain transfers to be overruled. In these cases, Blockstream AMP lets an issuer define an API endpoint for each asset that will handle the authorization of transfer requests. When an ‘issuer authorization endpoint’ has been specified against an asset, Blockstream AMP passes Blockstream Green transfer requests to the issuer for approval. The result from that is then returned to the Blockstream Green server, bypassing any rules that might be defined within Blockstream AMP. This enables custom transfer rules to be developed by the issuer, allowing for the integration of business logic that does not fit the default category-based authorization model of Blockstream AMP. For more details, see the Issuer Authorization Override section.
Issuers are also able to manage a list of locked UTXOs, which prevents spends from a list of issuer-defined outputs. This is useful in scenarios such as when a user has lost access to their original wallet and requires a reissuance of the asset.
Blockstream AMP Asset Transfers¶
In order for users to receive and transact a Blockstream AMP managed asset, a user must have enabled a Managed Assets account in Blockstream Green. The Blockstream Green wallet ensures that the issuer can report on asset ownership and apply restrictions of transfer to the asset. The transfer rules for each type of asset are:
Transfer Restricted Assets
Transfers are restricted based upon Blockstream AMP registered user records created by the issuer. This can either be done through the use of categories or by an issuer providing their own validation logic, accessed via an ‘issuer authorization endpoint’. The receiving destination must be a valid Managed Assets account or one of the issuer’s own Liquid treasury addresses. Read more about Transfer Restricted Assets. This type of asset allows, amongst other things, security tokens to be managed through Blockstream AMP. In order to apply the rules needed to conform to regulatory requirements, Blockstream AMP controls the issuance and transfer of these assets.
Issuer Tracked Assets
Issuers may want to issue an asset that only uses Blockstream AMP to track ownership and transfers. In this set up, transfers are only restricted by requiring that the receiving destination must be a valid Managed Assets account or one of the issuer’s own Liquid treasury addresses. registered users and category records are not used. Although there may be external restrictions placed on the users through the use of an ‘issuer authorization endpoint’, the lack of a Blockstream AMP registered user record means we refer to them as ‘Issuer Tracked’ assets, as transfers are only tracked and not restricted in any other way by Blockstream AMP. Read more about Issuer Tracked Assets.
Useful Liquid Terms¶
As Blockstream AMP’s assets are issued and transacted on the Liquid Network it is useful to familiarize yourself with some of the features of Liquid. Some of the main features of Liquid used by Blockstream AMP are outlined below.
Liquid is a Bitcoin sidechain built using the open-source Elements software. Liquid uses a federated consensus model which allows for rapid settlement of both Bitcoin and Issued Assets. Liquid also utilizes Confidential Transactions, which allows the asset amount and type to be hidden from any actors not directly involved in the transaction. Liquid also provides the ability to reveal any of this information to select third parties, such as auditors and regulators.
When managed through Blockstream AMP, those assets can represent the tokenized, digital form of traditional securities, a digital stimulus payment, a claim on gold, or any number of other use cases.
The act of creating a new asset on the Liquid Network is referred to as Asset Issuance. All Liquid assets are transferrable between Liquid users and make use of Liquid network features like Confidential Transactions.
Issuers can also add their asset to the Liquid Asset Registry, making it available to services that use the registry data, such as Blockstream Green. Issuers who want this option enabled must provide a ticker, the domain name used to validate ownership, and a public key during asset issuance.
Blockstream AMP uses Liquid to issue assets directly into an issuer’s wallet, it never holds any assets or reissuance tokens on the issuer’s behalf.
An asset can be created as reissuable during asset issuance. Reissuance is the act of creating more of an existing asset. The reissuance of additional amounts of existing assets is controlled by a special kind of asset, the reissuance token, which is created alongside the actual asset during issuance. Reissuance tokens can only be created during initial asset issuance.
Reissuance tokens act as a verifiably held right to increase the circulating amount of the associated asset. As with any other asset, they are exchangeable among participants on the network.
Care must be taken to ensure that only those authorized to reissue an asset are in possession of the reissuance token.
Blockstream AMP introduces some concepts that don’t apply to all assets on the Liquid network, only to those managed within Blockstream AMP. These are explained within this page.