Testnet Information

Bokuto¶

Network Name	Bokuto
Chain ID	737373
RPC URL	https://rpc-bokuto.katanarpc.com
Block explorer	https://bokuto.katanascan.com/
	https://explorer-bokuto.katanarpc.com/
Bridge UI	SOON
Faucet	https://faucet.katana.tools/
	Join the @katanadevs public developer community group for a code.

Chain Configuration¶

Gas Token	ETH
Block time	1 second
Gas Block Limit	60M units
Gas Pricing	EIP1559
Data Availability	EIP4844

Interacting with the Unified Bridge¶

Agglayer Documentation	https://docs.agglayer.dev/
Unified Bridge Address	`0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582`
Sepolia contract	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582
Bokuto contract	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582
Bokuto Bridge Service API	https://rpc-bridge-bokuto.katanarpc.com/
NetworkId (i.e. Agglayer Id)	`37`

For L2<->L2 transactions through the Agglayer, you’ll need the other L2’s Bridge Service API. The Unified Bridge Address lives in the same address across all testnets.

Testnet Tokens¶

Flow: Asset (Sepolia) -> Vault Bridge Token (Sepolia) -> Vault Bridge Token (Katana)

Name	Network	Address
`WETH`	Sepolia	0x04d08c8525B55c409201289C4ff5a204fa437d9f
`WBTC`	Sepolia	0x8dbBbF4E801774265171D7e101a9f346Fa6f56bD
`USDC`	Sepolia	0xCea1D25a715eC34adFB2267ACe127e8D107778dd
`USDT`	Sepolia	0xDA9E6CAA9F85aE060BCcd6a789E0C7D39A33e24f
`USDS`	Sepolia	0x5956982345967Dbc9648cD133c2fECb1eF132AE6

`Vault Bridge ETH`	Sepolia	0x188FFFc2562C67aCdB9a0CD0B819021DDfC82A6B
`Vault Bridge WBTC`	Sepolia	0x2CE29070ee5e65C4191d5Efca8E85be181F34B6d
`Vault Bridge USDC`	Sepolia	0xb62Ba0719527701309339a175dDe3CBF1770dd38
`Vault Bridge USDT`	Sepolia	0xdd9aCdD3D2AeC1C823C51f8389597C6be9779B28
`Vault Bridge USDS`	Sepolia	0x406F1A8D91956d8D340821Cf6744Aa74c666836C

`WETH (aka vbETH)`	Katana	0x84b3493fA9B125A8EFf1CCc1328Bd84D0B4a2Dbf
`WBTC (aka vbWBTC)`	Katana	0xe8255B44634b478aB10a649c6C207A654473dbed
`USDC (aka vbUSDC)`	Katana	0xc2a4C310F2512A17Ac0047cf871aCAed3E62bB4B
`USDT (aka vbUSDT)`	Katana	0xf6801557e17131Da48Fd03B2c34172872F936345
`USDS (aka vbUSDS)`	Katana	0x801f719178d9b85D4948ed146C50596273885a75

Tatara¶

Note: Tatara is our old testnet. It’s being replaced with Bokuto. Please use Bokuto if possible.

Chain Info¶

Network Name	Tatara
Chain ID	129399
RPC URL	https://rpc.tatara.katanarpc.com/
Block explorer	https://explorer.tatara.katana.network/

OpCodes	Appendix A - Opcodes
Precompiles	Appendix B - Precompiles
Predeploys	Appendix C - Predeploys

Interacting with the Core Applications and Core Assets¶

DEX - Sushi¶

Sushi Documentation: https://www.sushi.com/academy
Source Code: v3
Testnet Addresses:

SushiRouter	0xAC4c6e212A361c968F1725b4d055b47E63F80b75
V3Factory	0x9B3336186a38E1b6c21955d112dbb0343Ee061eE
V3PositionManager	0x1400feFD6F9b897970f00Df6237Ff2B8b27Dc82C

Lending/Borrowing - Morpho¶

Morpho Documentation: https://docs.morpho.org/
Source Code: morpho-blue v1.0.0
Testnet Addresses:

Morpho Blue	0xC263190b99ceb7e2b7409059D24CB573e3bB9021
Morpho Adaptive IRM	0x9eB6d0D85FCc07Bf34D69913031ade9E16BD5dB0
Morpho Chainlink Oracle V2 Factory	0xe795DD345aD7E1bC9e8F6B4437a21704d731F9E0
MetaMorpho Factory 1.1	0x505619071bdCDeA154f164b323B6C42Fc14257f7
Bundler3	0xD0bDf3E62F6750Bd83A50b4001743898Af287009
Public Allocator	0x8FfD3815919081bDb60CD8079C68444331B65042

Yield Aggregator - Yearn¶

Yearn Documentation: https://docs.yearn.fi/
Source Code: yearn-vaults-v3.0.4
Testnet Addresses:

yvAUSD ERC-4626	0xAe4b2FCf45566893Ee5009BA36792D5078e4AD60
yvWETH ERC-4626	0xccc0fc2e34428120f985b460b487eb79e3c6fa57

Native Stablecoin - AUSD¶

AUSD Documentation: https://developer.agora.finance/
Source Code: Blockscout
Testnet Address:

AUSD ERC-20	0xa9012a055bd4e0eDfF8Ce09f960291C09D5322dC
AUSD Faucet [testnet only]	0xd236c18D274E54FAccC3dd9DDA4b27965a73ee6C

Native Bitcoin Wrapper - Lombard¶

Lombard Documentation: https://docs.lombard.finance/
Source Code:
Testnet Address: NOT YET DEPLOYED

Vault Bridge Tokens¶

Note: The names and contract addresses of the vbTokens listed below may change.
Source Code: Contracts are verified on-chain
Testnet Addresses:

Mock USDC	0x2b9Ca0A8C773bb1B92A3dDAE9F882Fd14457DACc	Sepolia
Mock USDC BaseSepolia	0x3c95BB5f49F3643558aa8F699403564A652FBeB0	BaseSepolia
Mock USDT	0x18fDA3c97Ea92A04D1636D84948624b414D0058E	Sepolia
Mock USDS	0xfC7b006bDEd8e5D4A55FbaC7A91dAf3753f085CD	Sepolia
Mock WBTC	0xd67A804510739C33c578162A26324C83DCFC0a0A	Sepolia
vbETH	0x4CcD4CbDE5Ec758cCBf75f0be280647Ff359c17a	Sepolia
WETH Custom Token	0x17B8Ee96E3bcB3b04b3e8334de4524520C51caB4	Tatara
WETH Native Converter	0x3aFbD158CF7B1E6BE4dAC88bC173FA65EBDf2EcD	Tatara
vbUSDC	0x4C8414eBFE5A55eA5859aF373371EE3233fFF7CD	Sepolia
vbUSDC Custom Token	0x102E14ffF48170F2e5b6d0e30259fCD4eE5E28aE	Tatara
vbUSDC Native Converter	0x28FDCaF075242719b16D342866c9dd84cC459533	Tatara
vbUSDT	0xb3f50565f611D645e0DDB44eB09c4588B1601514	Sepolia
vbUSDT Custom Token	0xDe51Ef59663e79B494E1236551187399D3359C92	Tatara
vbUSDT Native Converter	0x8f3a47e64d3AD1fBdC5C23adD53183CcCD05D8a4	Tatara
vbWBTC	0xa278D086289f71a30D237feccBAF3698E43Bc5D6	Sepolia
vbWBTC Custom Token	0x1538aDF273f6f13CcdcdBa41A5ce4b2DC2177D1C	Tatara
vbWBTC Native Converter	0x3Ef265DD0b4B86fC51b08D5B03699E57d52C9B27	Tatara
vbUSDS	0x56b89A124376CB0481c93C3d94f821F262Dc0D7A	Sepolia
vbUSDS Custom Token	0xD416d04845d299bCC0e5105414C99fFc88f0C97d	Tatara
vbUSDS Native Converter	0x56342E6093381E2Bd732FFd6141b22136efB98Bf	Tatara

Asset Importer - Universal Assets¶

Documentation: https://docs.universal.xyz/universal-protocol
Source Code:
Testnet Addresses:

uBTC ERC-20	0xB295FDad3aD8521E9Bc20CAeBB36A4258038574e
uSOL ERC-20	0x79b2417686870EFf463E37a1cA0fDA1c7e2442cE
uXRP ERC-20	0x26435983DF976A02C55aC28e6F67C6477bBd95E7

Other Relevant Contracts¶

Agglayer Unified Bridge	0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582	Tatara
Safe(opens in a new tab)	0x69f4D1788e39c87893C980c06EdF4b7f686e2938	Tatara
SafeL2(opens in a new tab)	0xfb1bffC9d739B8D520DaF37dF666da4C687191EA	Tatara
MultiSend(opens in a new tab)	0x998739BFdAAdde7C933B942a68053933098f9EDa	Tatara
MultiSendCallOnly(opens in a new tab)	0xA1dabEF33b3B82c7814B6D82A79e50F4AC44102B	Tatara
Safe Singleton Factory(opens in a new tab)	0x914d7Fec6aaC8cd542e72Bca78B30650d45643d7	Tatara
Multicall 1	0x4e1d97344FFa4B55A2C6335574982aa9cB627C4F	Tatara
Multicall 2	0xfC0F3dADD7aE3708f352610aa71dF7C93087a676	Tatara
Multicall3(opens in a new tab)	0xcA11bde05977b3631167028862bE2a173976CA11	Tatara
create2Deployer(opens in a new tab)	0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2	Tatara
CreateX(opens in a new tab)	0xba5Ed099633D3B313e4D5F7bdc1305d3c28ba5Ed	Tatara
Batch Distributor	0x36C38895A20c835F9A6A294821D669995eB2265E	Tatara
Arachnid’s Deterministic Deployment Proxy(opens in a new tab)	0x4e59b44847b379578588920cA78FbF26c0B4956C	Tatara
Permit2(opens in a new tab)	0x000000000022D473030F116dDEE9F6B43aC78BA3	Tatara
ERC-4337 v0.6.0 EntryPoint(opens in a new tab)	0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789	Tatara
ERC-4337 v0.6.0 SenderCreator(opens in a new tab)	0x7fc98430eAEdbb6070B35B39D798725049088348	Tatara
ERC-4337 v0.7.0 EntryPoint(opens in a new tab)	0x0000000071727De22E5E9d8BAf0edAc6f37da032	Tatara
ERC-4337 v0.7.0 SenderCreator(opens in a new tab)	0xEFC2c1444eBCC4Db75e7613d20C6a62fF67A167C	Tatara
RIP-7212	0x0000000000000000000000000000000000000100	Tatara
Seaport 1.6	0x0000000000FFe8B47B3e2130213B802212439497	Tatara
Seaport Conduit Controller	0x00000000F9490004C11Cef243f5400493c00Ad63	Tatara
Smart Contracts & Security Admin Multisig	0x165BD6204Df6A4C47875D62582dc7C1Ed6477c17	Tatara

Appendix A - OpCodes¶

All OpCodes supported by op-geth

Appendix B - Precompiles¶

P256VERIFY (RIP-7212)

Appendix C - Predeploys¶

Note: Katana has a subset of predeploys from op-geth (See here for the full list of predeploys)

Contract	Address	Modified	Usable
WETH9 (You should use Katana’s WETH)	0x4200000000000000000000000000000000000006	No	Yes
SequencerFeeVault	0x4200000000000000000000000000000000000011	No	Yes
GasPriceOracle	0x420000000000000000000000000000000000000F	No	Yes
GovernanceToken	0x4200000000000000000000000000000000000042	No	Yes
L1Block	0x4200000000000000000000000000000000000015	No	Yes
ProxyAdmin	0x4200000000000000000000000000000000000018	No	Yes
BaseFeeVault	0x4200000000000000000000000000000000000019	No	Yes
L1FeeVault	0x420000000000000000000000000000000000001a	No	Yes
SchemaRegistry	0x4200000000000000000000000000000000000020	No	Yes
EAS (Ethereum Attestation Service)	0x4200000000000000000000000000000000000021	No	Yes
BeaconBlockRoot	0x000F3df6D732807Ef1319fB7B8bB8522d0Beac02	No	Yes
~~L2CrossDomainMessenger~~	~~0x4200000000000000000000000000000000000007~~	Yes	No
~~L2StandardBridge~~	~~0x4200000000000000000000000000000000000010~~	Yes	No
~~OptimismMintableERC20Factory~~	~~0x4200000000000000000000000000000000000012~~	No	No
~~L2ToL1MessagePasser~~	~~0x4200000000000000000000000000000000000016~~	Yes	No
~~L2ERC721Bridge~~	~~0x4200000000000000000000000000000000000014~~	Yes	No
~~OptimismMintableERC721Factory~~	~~0x4200000000000000000000000000000000000017~~	No	No
~~DEPRECATED - LegacyMessagePasser~~	~~0x4200000000000000000000000000000000000000~~	No	No
~~DEPRECATED - DeployerWhitelist~~	~~0x4200000000000000000000000000000000000002~~	No	No
~~DEPRECATED - LegacyERC20ETH~~	~~0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000~~	No	No
~~DEPRECATED - L1BlockNumber~~	~~0x4200000000000000000000000000000000000013~~	No	No