Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The Sequentia testnet

Sequentia is a Bitcoin sidechain for asset tokenization and disintermediated exchanges. Anyone can issue an asset on it, every asset can pay transaction fees, and every block is anchored to a Bitcoin block. The testnet at sequentiatestnet.com is the place to try all of it. Its coins and assets carry no value, so experiment freely.

This guide covers everything the site offers:

What it is for
The web walletA wallet in your browser for bitcoin and every Sequentia asset. The quickest way in.
The faucetFree testnet coins: the Sequence token (tSEQ) and sample assets.
Sequentia CoreThe full node and desktop wallet, for Linux and Windows.
The explorerEvery block, transaction and asset on the chain, and the Bitcoin testnet4 chain it anchors to.
CompagesBring assets in from Ethereum (Sepolia) and Solana (devnet), or peg bitcoin as SBTC.
Staking poolsWho produces blocks, and how to lend your stake’s weight to one of them.
EmissioEarn Sequence tokens, paid at mainnet launch, for testing and reporting problems.

New here? Start with Getting started. Something not working? Check the status page first, then report it.

Four things that set Sequentia apart

Bitcoin anchoring. Every Sequentia block names a Bitcoin block. If Bitcoin reorganises that block away, Sequentia reorganises with it, at once. On the testnet the parent chain is Bitcoin testnet4.

Native bitcoin. A Sequentia wallet holds real bitcoin beside its Sequentia assets, at the same tb1… address. Bitcoin needs no bridge to be used with Sequentia.

Fees in any asset. A transaction pays its fee in whichever asset a block producer accepts. The Sequence token (SEQ, tSEQ on the testnet) is one choice among the others; its only special role is staking, which is how block producers are chosen.

Transparent by default. Addresses and amounts are public, as on Bitcoin. Confidential transfers, which hide the amount and the asset, are available whenever you choose them, one transfer at a time.

Getting started

Ten minutes from nothing to your first transaction.

1. Get a wallet

Pick one:

  • The web wallet, at sequentiatestnet.com/wallet. Nothing to install. Choose Create new wallet, write down the twelve words it shows, and confirm them. The words are your recovery phrase: anyone who has them can spend from the wallet, and with them you can restore it anywhere. See The web wallet.
  • Sequentia Core, the full node with its desktop wallet, from sequentiatestnet.com/download/core, for Linux or Windows. It checks every block itself. On first start, press Create a new wallet and save a copy with File → Backup Wallet. See Sequentia Core.

Keep your recovery phrase or wallet backup private. Never type it into a website, a form or a message, including a problem report.

2. Get testnet coins

In the web wallet, the Receive tab asks the faucet for you. Otherwise copy an address (in Sequentia Core, Receive → Create new receiving address), open the faucet, paste it, choose an asset and send. The coins arrive within a minute. See The faucet.

3. Look it up

Paste your address into the explorer to see the payment that funded it: the amount, the asset and the block it went into.

4. Use it

  • Send an asset to a friend’s address or receive code. The fee can be paid in the asset you send.
  • Trade one asset for another in the web wallet’s Swap tab.
  • Issue an asset of your own.
  • Stake or delegate tSEQ: see Staking pools.
  • Bring in an asset from Ethereum or Solana with Compages.

5. Get rewarded for testing

Emissio pays Sequence tokens at mainnet launch for completing testnet tasks and for problems you find. Create an account there first, so you can paste your account code into the reports you send.

The web wallet

The web wallet at sequentiatestnet.com/wallet is a self-custodial wallet that runs entirely in your browser. It holds bitcoin (Bitcoin testnet4) and every Sequentia asset under one recovery phrase. Your keys are made and kept in the browser; the site never sees them.

Create or restore

  • Create new wallet makes a new twelve-word recovery phrase. Write it down before you confirm it.
  • Import a recovery phrase restores an existing wallet.

The wallet lives in this browser’s storage. Clearing the site’s data removes it from the browser, and your phrase brings it back. Never type the phrase into a website, a form or a message, including a problem report.

Balance

Each asset has one figure, and the total at the top is in your reference currency (choose it with Show values in). BTC is always the first row. An amount that has arrived but cannot be spent yet shows as “arriving” under its figure.

Receive

Receive shows a receive code: one code for any asset and any amount, BTC included. A payment from another Sequentia wallet to a receive code arrives in seconds. Each code is paid once, and a new one appears when it is. Any Bitcoin wallet reads the same code as a plain bitcoin address request. The faucet can pay it directly from the Receive tab.

Send

Paste a receive code, an address or an invoice under Recipient, choose the asset and the amount, and review. The review shows what arrives and the fee, in the asset that pays it. Nothing is signed until you press Send.

Trade

The Swap tab trades one asset for another: choose what you pay, what you get and how much, then Review and Trade. The market above the form shows the last price, the chart and recent trades. A trade with bitcoin settles after the next Bitcoin blocks, so it can take an hour or more; the row in Your trades says what is already done.

Modes

Settings (the gear) switches between user mode, where the wallet chooses how each payment travels, and developer mode, which shows every route by name with its own balance and manual controls. Each wallet keeps its own setting.

Report a problem

More → Report a problem sends a report without leaving the wallet:

  1. What happened? What you did, what you expected, and what happened instead.
  2. Emissio account code (optional): paste it to be credited if the report is accepted.
  3. Send report. The wallet answers with the report’s number.

The report includes the wallet’s version, its mode and its recent errors, with anything that looks like an address or a key removed. It never includes your recovery phrase or your keys, and the wallet refuses a description that contains words of your phrase. Your address is added only if you tick Also send my address, and What will be sent shows the exact report before you send it.

The faucet

The faucet at sequentiatestnet.com/faucet sends free testnet coins to any Sequentia testnet address:

AssetWhat it is
tSEQThe Sequence token on the testnet: stake it, or spend it like any other asset
USDXA test dollar, sent in amounts large enough to try the platforms that price in dollars
EURXA test euro
GOLD, SILVR, OILXTest commodity tokens

All of them sends one of each.

How to ask

  1. Copy an address from your wallet:
    • the web wallet: Receive (its Receive tab can also ask the faucet itself);
    • Sequentia Core: Receive → Create new receiving address;
    • a node: sequentia-cli getnewaddress.
  2. Paste it into the faucet, choose the asset and send.
  3. The page shows the transaction; it confirms within about a minute.

Limits

  • One payment of each asset per address, and per connection, each hour.
  • tSEQ is paid from a reserve that releases one payment every few minutes. When it asks you to wait, try again a little later.
  • Addresses starting tb1 are the usual ones. Confidential addresses (tsqb1…) receive every asset except tSEQ.

The amount of each asset is shown on the page.

Sequentia Core

Sequentia Core is the full node and its desktop wallet. It downloads and checks every block itself, follows Bitcoin testnet4 to check each block’s anchor, and is the software block producers run. It is built from ConcatenaLabs/Sequentia.

Download

sequentiatestnet.com/download/core has the current release for Linux (x86-64) and Windows (64-bit), and a SHA256SUMS file to check the download against:

sha256sum -c SHA256SUMS --ignore-missing

Install and run

Linux. Extract the tarball and start the desktop wallet:

tar xzf sequentia-core-*-linux-x86_64.tar.gz
cd sequentia-core-*/
bin/sequentia-qt

Windows. Run the installer, then open Sequentia Core from the Start menu.

Sequentia Core connects to the testnet on its own; no configuration is needed. The first start downloads the chain, which takes a while. The wallet is usable once the progress bar at the bottom is gone.

To make a wallet, press Create a new wallet (or File → Create Wallet). Save a copy of it with File → Backup Wallet, and keep the copy private: it holds the keys.

Run it as a node

The same download carries the daemon and its command-line client:

bin/sequentiad -daemon
bin/sequentia-cli getblockchaininfo     # height and sync progress
bin/sequentia-cli getanchorstatus       # the tip's Bitcoin anchor, and whether it checks
bin/sequentia-cli createwallet mywallet
bin/sequentia-cli getnewaddress
bin/sequentia-cli stop

The data directory is ~/.elements on Linux and %APPDATA%\Elements on Windows, and the configuration file in it is elements.conf. The testnet is the default chain, so no chain= line is needed.

What the wallet does

  • Send and receive bitcoin and any Sequentia asset. Every address starting tb1 works on both chains: the same address receives bitcoin and Sequentia assets.
  • Pay fees in any accepted asset. The fee is shown in that asset’s own units.
  • Issue assets: your own token, with a name and a ticker registered on the asset registry.
  • Stake and delegate from the Staking tab: see Staking pools.
  • Confidential transfers when you want them: a confidential address hides the amount and the asset of the payments it receives.

Following Bitcoin

Each Sequentia block names a Bitcoin testnet4 block. Sequentia Core checks those anchors against Bitcoin, and if Bitcoin reorganises an anchored block away, the node reorganises Sequentia to match. getanchorstatus shows the anchor of the newest block and whether it checked.

The explorer

The explorer at sequentiatestnet.com/explorer shows everything on the Sequentia testnet: blocks, transactions, addresses and issued assets. Its twin at sequentiatestnet.com/testnet4 shows Bitcoin testnet4, the chain Sequentia anchors to.

Look something up

Paste into the search box:

  • an address, to see its balance in each asset and every transaction that touched it;
  • a transaction id, to see its inputs, outputs, fee (in the asset that paid it) and the block that confirmed it;
  • a block height or hash;
  • an asset id, to see the asset’s name, ticker, issuance and supply.

What you see on Sequentia

  • Assets by name. Registered assets show their ticker and their own decimals.
  • Fees in any asset. A transaction’s fee is listed in the asset it was paid in.
  • Transparent by default. Amounts and assets are public. A confidential output shows that a payment happened, without its amount or asset.
  • Contracts. A spend of a known contract (an escrow, a drip, an order) is named after its template.

Data for scripts

The explorer’s data is the Esplora REST API, at https://sequentiatestnet.com/api/ for Sequentia and https://sequentiatestnet.com/testnet4/api/ for Bitcoin testnet4. For example:

curl https://sequentiatestnet.com/api/blocks/tip/height
curl https://sequentiatestnet.com/api/address/<address>

Compages

Compages, at sequentiatestnet.com/bridge, brings assets from other chains onto Sequentia and takes them back. On the testnet it connects:

FromYou sendYou receive on Sequentia
Ethereum (Sepolia)ether or any ERC-20the matching asset, ticker ending .e
Solana (devnet)SOL or any SPL tokenthe matching asset, ticker ending .s
Bitcoin (testnet4)BTCSBTC, bitcoin pegged 1:1

Compages is run by an operator who holds what is deposited; returning the Sequentia asset releases the original.

Bring an asset in from Ethereum

  1. Choose Ethereum (Sepolia) and Connect wallet (an Ethereum wallet with Sepolia ether for gas).
  2. Choose the asset and the amount, and paste your Sequentia address, or press Use my Sequentia wallet.
  3. Deposit, and approve it in your Ethereum wallet.
  4. The steps show as they complete: deposit sent, Ethereum finality, minting, delivered. Track a deposit finds one again later.

Solana works the same way from Solana (devnet): get a deposit address, send to it, and the asset arrives on Sequentia.

Send it back

Under Sequentia → Ethereum, enter the Ethereum address that should receive the funds and press Get my redemption address. Send the bridged asset to that Sequentia address from any Sequentia wallet. The vault releases the original once the return’s Bitcoin anchor is buried deep enough that a Bitcoin reorganisation cannot undo it, so a return takes longer than a deposit.

Bitcoin needs no bridge

Every Sequentia wallet holds real bitcoin at its tb1… address. To use bitcoin with Sequentia, send it to that address as it is.

SBTC, bitcoin pegged 1:1 on Sequentia and backed by BTC held in a reserve, is for the two things native bitcoin cannot do on the Sequentia chain: confidential transfers, and anything that needs a covenant, such as a limit order that rests on the chain until it is filled. Bitcoin → SBTC gives you a deposit address; SBTC → Bitcoin gives you a return address.

Staking pools

Sequentia’s blocks are produced by stakers: holders of the Sequence token who lock it in a staking output. The more stake a key holds, the more often it is chosen to propose a block, and a committee of stakers certifies each block. A block’s reward is the fees of the transactions in it, in whatever assets they were paid.

The board at sequentiatestnet.com/pools lists every staker producing blocks: its stake, how much was delegated to it and by how many, how reliably it produces, and what it has committed on-chain to paying the people who delegate to it.

Stake

Staking takes at least 40,000 tSEQ, which the faucet can provide. The stake stays in your wallet, locked by your own key, and can be withdrawn after an unbonding delay.

  • Sequentia Core: the Staking tab.

  • A node:

    sequentia-cli -rpcwallet=<wallet> getnewaddress
    sequentia-cli -rpcwallet=<wallet> getaddressinfo <address>     # its "pubkey"
    sequentia-cli -rpcwallet=<wallet> registerstake <pubkey> 40000
    sequentia-cli -rpcwallet=<wallet> startstaking
    

A stake produces blocks only while its node is running. If you would rather not run one, delegate.

Delegate

Delegating lends your stake’s weight to a pool and shares in the rewards of the blocks it produces.

  • Your coins stay yours. The staking output keeps your key as its only spending condition; the pool never holds anything of yours.
  • You can leave at any time, in one action, without anyone’s permission.
  • What you trust the pool with is the reward. Its payout commitment is on-chain, and any change has to be announced 1,440 blocks (about a day) in advance. The board puts pending announcements at the top.

From Sequentia Core: the Staking tab lists the pools; pick one and delegate. From a node:

sequentia-cli -rpcwallet=<wallet> delegatestake "<pool key>"
sequentia-cli -rpcwallet=<wallet> listdelegations
sequentia-cli -rpcwallet=<wallet> undelegatestake

Read the board

ColumnMeaning
PayoutProportional (your share of every reward, minus the fee, claimable on-chain), Lottery (each block pays one delegator, drawn by stake), Fixed address (every block pays one address the operator named), or None (the operator keeps every reward)
FeeThe pool’s share of the rewards
ProductionBlocks produced over the last 500 against what its stake entitles it to: On target, Missing blocks or Offline

Run a pool

In Sequentia Core, open the Staking tab and choose Run a staking pool, then pick a payout type and a fee. From a node:

sequentia-cli -rpcwallet=<wallet> -named announcepayout mode=split commission_bp=500

mode=lottery makes a lottery pool and mode=direct address=… a fixed address; the fee is in basis points (500 is 5%). The pool appears on the board once the announcement is mined.

Emissio

Emissio is the Sequentia community rewards programme. You earn Sequence tokens (SEQ) for work on the testnet: completing tasks, winning competitions, and reporting problems and vulnerabilities. Your balance is paid on the Sequentia mainnet at launch, to a mainnet address you give.

Join

  1. Register with an email address and a password, and confirm the email.
  2. On Account, note your account code and your proof decimals. Paste the account code into a problem report you send from the web wallet, so it is credited to you.
  3. Verify a social account. You can earn without one, but the launch payout needs it.
  4. Add your mainnet address (it starts bc1) before launch. The Address guide explains how to make one safely with any well-audited Bitcoin wallet; use a fresh recovery phrase for it.

Earn

  • Tasks cover every part of the testnet: the web wallet, the faucet, Sequentia Core, the explorer, Compages, the staking pools and Emissio itself. Each task says what to do and what evidence to submit.
  • Proof that a transaction is yours. Your account has proof decimals: eight digits shown on the Account page. A transaction you submit as evidence must have a transparent output whose amount ends in exactly those digits, for example 1.<your proof decimals> tSEQ.
  • Bug reports are rewarded by severity once a reviewer accepts them. Report from Emissio’s Bugs page, or from the web wallet with Report a problem.
  • Security reports go through the Security page, privately. Do not disclose a vulnerability publicly before it is fixed.
  • Competitions have their own prizes and deadlines.

Every reward is reviewed before it is credited. One account per person; the Program rules page lists the rest.

Status and problem reports

Is it working?

The status page at sequentiatestnet.com/status says whether the testnet is healthy right now:

  • The chain: its height, how long ago the last block came (one is expected about every minute), and whether the newest block’s Bitcoin anchor is current.
  • Each service: the explorer, the web wallet, the faucet, Compages, the staking pools, Emissio and the Sequentia Core download, each Working or Not working, with its checks over the last hour and its share of passed checks over the last day.

Every service is checked once a minute through its public address, so the page sees what you see. If something you use is marked Not working, it is already known.

Report a problem from the web wallet

More → Report a problem in the web wallet sends a report without leaving it:

  1. What happened? What you did, what you expected, and what happened instead.
  2. Emissio account code (optional): paste it to be credited if the report is accepted.
  3. Send report. The wallet answers with the report’s number.

The report includes the wallet’s version, its mode and its recent errors, with anything that looks like an address or a key removed. It never includes your recovery phrase or your keys, and the wallet refuses a description that contains words of your phrase. Your address is added only if you tick Also send my address, and What will be sent shows the exact report before you send it.

Report a problem from anywhere else

The Bugs page on Emissio takes a report about any part of the testnet, with the steps to reproduce it and a screenshot. Security issues go to Emissio’s Security page instead, privately.

A good report says what you did step by step, what you expected, what happened, and when. Accepted reports are rewarded by severity.

FAQ

Do testnet coins have any value?

No. tSEQ, the sample assets and testnet bitcoin are for testing only, and the testnet can be reset. What you earn on Emissio is a separate balance, paid in Sequence tokens at mainnet launch.

What is the difference between Sequentia, the Sequence token, SEQ and tSEQ?

Sequentia is the network. The Sequence token is its token; its ticker is SEQ, and on the testnet tSEQ.

Which asset pays my fees?

Any asset that block producers accept. Your wallet offers the assets you hold that are accepted, and shows the fee in that asset’s own units before you sign. The Sequence token has no special place in fees.

How long does a payment take?

It shows at once and confirms in the next block, about a minute later. A payment from the web wallet to another wallet’s receive code arrives in seconds. A trade with bitcoin waits for Bitcoin blocks and can take an hour or more.

When is a payment final?

A confirmed payment stands as long as Bitcoin does not reorganise the Bitcoin block its Sequentia block anchors to. If Bitcoin reorganises that block away, Sequentia reorganises with it. Services that release funds elsewhere, such as Compages, wait until the anchor is buried deep enough.

Is the bitcoin in my wallet real bitcoin?

Yes: native bitcoin on Bitcoin testnet4, held at the same tb1… address as your Sequentia assets. SBTC is a separate asset, bitcoin pegged 1:1 on Sequentia, needed only for confidential transfers and covenants. See Compages.

Are my transactions private?

They are public by default, as on Bitcoin: anyone can see addresses, amounts and assets on the explorer. Confidential transfers hide the amount and the asset; you choose them per transfer, by receiving at a confidential address (tsqb1…).

I lost my wallet.

  • Web wallet: choose Import a recovery phrase.
  • Sequentia Core: restore the backup file. Open Window → Node window, choose the Console tab and run restorewallet "<a name>" "<path to the backup>".

Without the phrase or the backup nobody can recover the wallet for you. On the testnet, create a new wallet and ask the faucet again.

Someone else has my recovery phrase or my wallet backup.

Treat that wallet as lost: create a new one and move what it holds. On the testnet this costs nothing; on any real network it is how coins are stolen.

Can I issue my own asset?

Yes. In Sequentia Core (the Assets tab), or with sequentia-cli issueasset, an asset is issued in one transaction. Register its name and ticker so wallets and the explorer show them.

Where do I ask for help?

Check the status page for known problems, then send a report from the web wallet (More → Report a problem) or on Emissio’s Bugs page.