Get started

Set up a wallet and connect to Butane.

1

Set up a wallet

We recommend Lace. The app also officially supports Eternl and, on mobile, Tokeo.

You can also connect a compatible wallet through WalletConnect (beta). Other wallets may also work. When you connect, the app lists any it detects under Also detected.

2

Fund it with ADA

Once the wallet is installed and backed up, it needs ADA to pay transaction fees. You can buy ADA on an exchange and withdraw it to the wallet.

3

Connect to Butane

Open the Butane app and select Connect Wallet in the top right. In the Wallet Connector, select your wallet, select Connect, then approve the request in the wallet.

Choosing a wallet in the Wallet Connector.

To borrow, you also need collateral that the market accepts. Each market lists its collateral on Markets. To get BTN or a synthetic, see BTN and synthetics.

Try Butane on Preview

Preview is Cardano's test network. Butane runs there with test assets that have no monetary value, so you can try every part of the app without risking funds.

1. Switch your wallet to the Preview network. Mainnet ADA cannot be used there.

2. Request test ADA from the Cardano testnet faucet, with Preview selected as the network.

3. Open the Butane Preview app and connect your wallet.

4. Open the wallet menu in the top right and select Settings. Under Preview, open the Test collateral faucet, select the assets and the amount of each, then mint them and sign the transaction.

Preview markets use test parameters, so their rates, conversion rates and lock periods differ from Mainnet.

Find your way around

The Overview page.

• Overview shows the protocol's total debt and collateral.

• Markets lists the synthetic markets and their parameters.

• Portfolio summarises your wallet assets, collateral, staked synthetics, debt and position health.

• Positions is where you manage your CDPs, and liquidate or redeem other people's.

• Borrow, Earn and Swap open a CDP, stake a synthetic and swap one. See Borrow, Earn and Swap.

• History lists the actions made from the connected wallet, or across the whole protocol.

Action composability

Butane can put many actions into one transaction, across several CDPs and markets. You can repay one CDP and open another, liquidate several CDPs at once, or act in several markets, then sign once. The transaction goes through as a whole or not at all, so you are never left halfway through.

In the app this is Bundle actions, in Settings, and it is on by default. Actions you confirm on Positions and Borrow are collected into one transaction, and each shows a notice with an Undo option. When you are ready, select Review Transaction, the cart button in the header (at the bottom of the screen on mobile). The review lists every action with the assets paid and received and the fees. Select Confirm transaction and sign in your wallet.

With Bundle actions off, each action is submitted on its own as soon as you confirm it. Staking, unstaking and swapping are always submitted as their own transactions.