Guides
Katana Network
Overview
Katana Network is a Layer 2 blockchain built on the OP Stack and part of the Superchain ecosystem. It provides one-second block times with minimal transaction fees, using ETH as its native gas token. Katana Network inherits Ethereum's security through periodic state commitments to mainnet and supports standard Ethereum development tooling, including cross-chain interoperability through the Superchain bridge.
Explorer
https://katanascan.com/Wallet Types
BitGo enables holding katanaeth in the following wallet types:
| Multisig Cold | Multisig Hot | MPC Cold | MPC Hot | |
|---|---|---|---|---|
| Custody | ❌ | ❌ | ✅ | ❌ |
| Self-Custody | ❌ | ❌ | ✅ | ✅ |
Ticker Symbols
| Mainnet | Testnet |
|---|---|
| KATANAETH | TKATANAETH |
Faucet
The Katana Bokuto faucet is access-code-gated and may be temporarily unavailable. The recommended way to obtain testnet tkatanaeth is to bridge ETH from Sepolia to Bokuto.
Bridge: https://bridge.katana.network/
Units
Each Katana ETH contains 1,000,000,000,000,000,000 (1018) wei, so not even a single unit can be stored numerically without exceeding the range of JavaScript numbers. Gas fees use gwei as the denomination.
- 1 katanaeth =
1018wei - 1 wei =
10-18katanaeth - 1 gwei =
10-9katanaeth
For that reason, only string balance properties are available, which are balanceString, confirmedBalanceString, and
spendableBalanceString.
Tokens
Katana Network supports the ERC20 token standard. ERC20 tokens on Katana Network are available as BitGo supported assets.
Fees
Katana Network supports EIP-1559 gas estimation. As an OP Stack L2, Katana accounts for both L2 execution costs and L1 data posting fees to Ethereum. The eth_estimateGas RPC endpoint returns a value that already considers both components. You cannot set a fixed 21K gas limit since the L1 data fee component changes over time with L1 prices.
The base fee is the minimum price per unit of gas required for a transaction to be included in a block. Transactions must specify a maximum base fee higher than the block base fee to be included. The priority fee is paid on top of the base fee and is used to incentivize faster sequencer processing.
Create Wallet
bitgo
.coin("tkatanaeth")
.wallets()
.generateWallet({
label: "My Test Wallet",
passphrase: "secretpassphrase1a5df8380e0e30",
enterprise: "5612c2beeecf83610b621b90964448cd",
})
.then(function (wallet) {
// print the new wallet
console.dir(wallet);
});
export BITGO_EXPRESS_HOST="<YOUR_LOCALHOST>"
export COIN="tkatanaeth"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export LABEL="<DESIRED_WALLET_NAME>"
export PASSPHRASE="<YOUR_BITGO_LOGIN_PASSPHRASE>"
export ENTERPRISE_ID="<YOUR_ENTERPRISE_ID>"
curl -X POST \
http://$BITGO_EXPRESS_HOST/api/v2/$COIN/wallet/generate \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{
"label": "'"$LABEL"'",
"passphrase": "'"$PASSPHRASE"'",
"enterprise": "'"$ENTERPRISE_ID"'"
}'
Create Address
bitgo
.coin("tkatanaeth")
.wallets()
.getWallet({ id: "585c51a5df8380e0e3082e46" })
.then(function (wallet) {
return wallet.createAddress();
})
.then(function (newAddress) {
// print new address details
console.dir(newAddress);
});
export WALLET="585c51a5df8380e0e3082e46"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
curl -X POST \
-H "Authorization: Bearer $ACCESS_TOKEN" \
https://app.bitgo-test.com/api/v2/tkatanaeth/wallet/$WALLET/address
Consolidate Balance
Katana Network MPC wallets support multiple receive addresses. Each receive address is an externally owned account (EOA) controlled by the wallet key. To consolidate funds from receive addresses back to the base address, use the BitGo wallet consolidation API.
Estimate Fee
const BitGoJS = require("../../../src/index.js");
const bitgo = new BitGoJS.BitGo({ env: "test" });
const accessToken = process.env.ACCESS_TOKEN;
const coin = "tkatanaeth";
async function getFeeEstimate() {
try {
await bitgo.authenticateWithAccessToken({ accessToken });
const res = await bitgo.coin(coin).feeEstimate({ numBlocks: 2 });
console.dir(res);
} catch (err) {
console.error("Error fetching fee estimate:", err);
}
}
getFeeEstimate();
export COIN="tkatanaeth"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
curl -X GET \
https://app.bitgo-test.com/api/v2/$COIN/tx/fee \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $ACCESS_TOKEN"
Transact
const tx = await fundedWallet.send({
address: "<DESTINATION_ADDRESS>",
amount: "<AMOUNT>",
walletPassphrase: process.env.PASSWORD,
});
export BITGO_EXPRESS_HOST="<YOUR_LOCALHOST>"
export COIN="tkatanaeth"
export WALLET_ID="<YOUR_WALLET_ID>"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export ADDRESS="<DESTINATION_ADDRESS>"
export AMOUNT="<AMOUNT_IN_BASE_UNITS>"
export WALLET_PASSPHRASE="<YOUR_WALLET_PASSPHRASE>"
curl -X POST \
http://$BITGO_EXPRESS_HOST/api/v2/$COIN/wallet/$WALLET_ID/sendcoins \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d '{
"address": "'"$ADDRESS"'",
"amount": "'"$AMOUNT"'",
"walletPassphrase": "'"$WALLET_PASSPHRASE"'"
}'
Stake
Katana Network isn't a stakeable asset.