Issue an asset
Creating an asset takes ten seconds. Making it show its name in other people’s wallets takes three more steps, because wallets refuse to display a name unless the owner of a website says the asset is theirs. That is the whole point: it stops someone else issuing a token, calling it yours and fooling your customers.
You need a wallet with a little of any accepted asset for the fee, and a website you control.
Where to issue
- Web wallet: More → Issuance.
- Sequentia Core: the Assets page, which guides you through the steps below.
- A node:
sequentia-cli issueasset.
Step 1: find your exact domain
Websites often answer to two names, example.com and www.example.com. Only one is the right answer, and your browser will tell you which.
- Open a new tab, type your website’s address and press Enter.
- Wait for the page to finish loading.
- Read what the address bar says now.
Whatever it shows after loading is your domain. If you typed one name and the bar shows another, your website redirected you, and the name it moved you to is the one that works. Write down just the name: no https://, no slash.
Go deeperWhy this matters so much
The check that proves the domain is yours is made by a machine, and it is deliberately literal. It asks your website for one exact address and accepts only a direct answer. If your site replies “go to the www version instead”, the machine does not follow. It records a failure, and your asset stays nameless permanently.
A person would shrug at the difference between the two names. The machine cannot, because being relaxed about which website answered is exactly how impersonation gets in.
Sequentia Core trims https:// and anything after the first slash for you, checks that the name exists before it lets you spend anything, and has an Open my site button that runs the address-bar test.
Step 2: fill in the rest
| Field | What to enter |
|---|---|
| Name | What people read. Spaces and accents are fine. |
| Ticker | The short symbol, such as GOLD. Up to 12 characters: letters, digits, dot or dash. First come, first served across the network, so pick something unlikely to collide. |
| Decimal places | How finely the asset divides. 8 works like bitcoin; 0 means whole units only, for things that cannot be halved. |
| Amount | How many units to create now. |
| Allow making more later | Ticked, your wallet also receives a reissuance token: the key that can create more units. Unticked, the amount above is all there will ever be. Required for a supervised asset. |
Step 3: issue
Confirm the transaction. It is included in the next block, about a minute later. The asset now exists and has an asset id: 64 characters that identify it for ever. At this point wallets show that id and not a name.
Sequentia Core then offers two files. Save both.
- The proof file: a file with a long name and no extension. It is Step 4.
- The contract: a
.jsonfile holding your asset’s name, ticker, decimals, domain and key. The chain kept only its fingerprint. Treat it as a backup: a wallet restored from scratch can only register your asset by loading this file.
Step 4: put the proof file on your website
Do not rename the file: its name is what ties it to your asset. It has to be reachable in a folder called .well-known at the top of your site:
https://www.example.com/.well-known/sequentia-asset-proof-<your asset id>The file must be served directly at that address, with no redirect. Hosts that let you place a file at an arbitrary path (your own server, most hosting control panels, Netlify, Vercel, Cloudflare Pages, GitHub Pages) can do this. Website builders that only handle media uploads generally cannot, so check before issuing.
Step 5: register
Register the asset with the asset registry from the same screen. The registry recomputes the id from the chain, checks that your contract produces it, fetches your file, and marks the asset verified. From then on, every wallet and the explorer show the name and ticker.
The full walkthrough, platform by platform and with what to do when a check fails, is in issuing-an-asset-guide.md.
Supervised or not
Before issuing, decide whether the asset is supervised: whether you, the issuer, will have the power to freeze the coins at a given address.
- Choose it if the asset represents a claim you are legally obliged to be able to arrest, such as a fiat-backed stablecoin.
- It needs two keys: one for daily use, one kept in cold storage to replace the first if it is stolen.
- It is declared at issuance and is part of the asset id. An unsupervised asset can never become supervised, and a supervised one can never be released.
What a supervised issuer can and cannot do is set out in For issuers. Operating instructions: supervised-assets.md.
If you need more than a freeze
For a security that only approved investors may hold, or that vests, or whose transfers are capped, see the comparison of OpenAMP and OpenDAMP.
After issuing
- Get it accepted for fees. An asset pays fees wherever a block producer has priced it. Producers add assets that have a market price and liquidity.
- Get it traded. List it on SeqDEX by placing the first orders.
- Reissue or burn from the same Issuance screen.