diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 786271d1..a3f6bba9 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -71,6 +71,35 @@ function sidebar() { { text: 'On Devnet', link: '/flame/flame-devnet.md' }, ] }, + { + text: 'Bridging', + collapsed: true, + items: [ + { text: 'Use the Bridge UI', link: '/bridging/bridge-ui.md' }, + { text: 'CLI Bridging Overview', link: '/bridging/cli-bridging-overview.md' }, + { text: 'Bridge on Mainnet Alpha', collapsed: true, items: [ + { text: 'Bridge To Astria', link: '/bridging/mainnet-alpha/bridge-to-astria-mainnet-alpha.md' }, + { text: 'Withdraw From Astria', link: '/bridging/mainnet-alpha/withdraw-from-astria-mainnet-alpha.md' }, + { text: 'Bridge to Flame', link: '/bridging/mainnet-alpha/bridge-to-flame-mainnet-alpha.md' }, + { text: 'Withdraw from Flame', link: '/bridging/mainnet-alpha/withdraw-from-flame-mainnet-alpha.md' }, + ] + }, + { text: 'Bridge on Dawn Testnet', collapsed: true, items: [ + { text: 'Bridge To Astria', link: '/bridging/testnet/bridge-to-astria-testnet.md' }, + { text: 'Withdraw From Astria', link: '/bridging/testnet/withdraw-from-astria-testnet.md' }, + { text: 'Bridge to Flame', link: '/bridging/testnet/bridge-to-flame-testnet.md' }, + { text: 'Withdraw from Flame', link: '/bridging/testnet/withdraw-from-flame-testnet.md' }, + ] + }, + { text: 'Bridge on Dusk Devnet', collapsed: true, items: [ + { text: 'Bridge To Astria', link: '/bridging/devnet/bridge-to-astria-devnet.md' }, + { text: 'Withdraw From Astria', link: '/bridging/devnet/withdraw-from-astria-devnet.md' }, + { text: 'Bridge to Flame', link: '/bridging/devnet/bridge-to-flame-devnet.md' }, + { text: 'Withdraw from Flame', link: '/bridging/devnet/withdraw-from-flame-devnet.md' }, + ] + }, + ] + }, { text: 'Networks', collapsed: true, diff --git a/docs/astria-evm/overview.md b/docs/astria-evm/overview.md deleted file mode 100644 index 86a8713a..00000000 --- a/docs/astria-evm/overview.md +++ /dev/null @@ -1,19 +0,0 @@ -# EVM - -The Astria EVM is a rollup running on top of the Astria -Sequencer Network. It is a fork of -[Geth](https://github.com/ethereum/go-ethereum). - -## RPC Endpoints - -Below are the RPC endpoint for the different Flame EVMs running on different networks. - -| Network | EVM RPC | -|---|---| -| Dawn | [https://rpc.evm.dawn-0.astria.org](https://rpc.flame.dawn-0.astria.org) | -| Dusk | [https://rpc.evm.dusk-10.devnet.astria.org](https://rpc.evm.dusk-10.devnet.astria.org) | -| Local | [http://127.0.0.1:26657](http://127.0.0.1:26657) | - -## Bridging - -TODO add info on bridging flow. diff --git a/docs/bridging/bridge-ui.md b/docs/bridging/bridge-ui.md new file mode 100644 index 00000000..1a4901cf --- /dev/null +++ b/docs/bridging/bridge-ui.md @@ -0,0 +1,53 @@ + + + + +# Use the Astria Bridge UI + +Astria is an IBC chain and is connected to Celestia, Noble, Osmosis, and Stride. + +> [!IMPORTANT] +> The Astria Bridge UI is the recommended method for bridging to Astria. +> +> Visit the Astria Bridging UI rel="noopenernoreferrer">here. + +## Navigate to the Bridge UI for your Desired Network + +| Network | Bridge UI Link | +|---|---| +| Astria Mainnet Alpha | Mainnet Bridge UI | +| Astria `dawn-1` Testnet | Testnet Bridge UI | +| Astria `dusk-11` Devnet | Devnet Bridge UI | + +## Supported Wallets + +> [!TIP] +> If Flame doesn't show in your Keplr wallet you can add it [here](https://chains.keplr.app/). + +[Keplr](https://www.keplr.app/) is supported for bridging from Celestia, Noble, +Osmosis, and Stride as well as the Flame EVM. + +Any [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963) compatible +wallet should work with Flame, we have tested [Keplr](https://www.keplr.app/), [Metamask](https://metamask.io/) and [Coinbase +Wallet](https://www.coinbase.com/wallet). + +## Bridge to Flame + +1. Confirm that the Bridge UI is set to **Deposit**. +2. Select your desired starting network and connect your Keplr wallet +3. Select Flame as the destination and connect your EVM wallet. +4. Set an amount. +5. Click `Deposit`. + +## Withdraw from Flame + +1. Confirm that the Bridge UI is set to **Withdraw**. +2. Select Flame as the starting network and connect your EVM wallet. +3. Select your desired destination network and connect your Keplr wallet. +4. Set an amount. +5. Click `Withdraw`. diff --git a/docs/bridging/cli-bridging-overview.md b/docs/bridging/cli-bridging-overview.md new file mode 100644 index 00000000..c495ed33 --- /dev/null +++ b/docs/bridging/cli-bridging-overview.md @@ -0,0 +1,136 @@ + + + + +# Bridge to Astria + +Astria is an IBC chain and is connected to Celestia, Noble, Osmosis, and Stride. + +> [!IMPORTANT] +> The Astria Bridge UI is the recommended method for bridging to Astria. +> +> Visit the Astria Bridging UI rel="noopenernoreferrer">here. + +Manual bridging via the command line is available for power users. + +## IBC Connections + +### Mainnet + +| Connected Network | Channel | Astria Channel | +|---|---|---| +| Celestia | `channel-48` | `channel-0` | +| Noble | `channel-104` | `channel-1` | +| Osmosis | `channel-85486` | `channel-2` | +| Stride | `channel-285` | `channel-3` | + +### Testnet (dawn-1) + +| Connected Network | Channel | Astria Dawn Channel | +|---|---|---| +| Celestia Mocha-4 | `channel-160` | `channel-0` | +| Noble | `channel-232` | `channel-1` | +| Stride | `channel-53` | `channel-2` | +| Osmosis | `channel-9186` | `channel-3` | + +### Devnet (dusk-11) + +| Connected Network | Channel | Astria Dusk Channel | +|---|---|---| +| Celestia | `channel-159` | `channel-0` | +| Noble | `channel-231` | `channel-1` | + +## CLI Bridging Dependencies + +To bridge funds directly on the command line, install the following. + +Make sure Go is installed and the `/go/bin` is added to your path. This is +required for building and successfully using `celestia-appd`, `nobled`, +`osmosisd`, and `strided`: + +- [Go](https://go.dev/doc/install) + +Install the `astria-cli`: + +- See [`astria-cli` installation + docs](../developer/astria-cli/astria-cli-installation.md) + +Install the `celestia-appd` cli: + +- See [`celestia-appd` installation + docs](https://docs.celestia.org/how-to-guides/celestia-app) + +Install Foundry: + +- See the [Foundry installation + docs](https://book.getfoundry.sh/getting-started/installation). + +Build the `nobled` cli from source: + + + +Build the `strided` cli from source: + + + +Build the `osmosisd` cli from source: + + + +## Creating Accounts + +You will need an account for all networks you are interacting with. + + + +## Funding Testnet Accounts + +### Celestia Mocha Testnet + +Fund your Celestia address using the Celestia testnet faucet +[here](https://docs.celestia.org/how-to-guides/mocha-testnet#mocha-testnet-faucet). + +### Noble Testnet + +Fund your Noble address using the Noble testnet faucet +[here](https://faucet.circle.com/). Select `Noble Testnet` in the dropdown. + +### Astria `dusk` Devnet + +Fund your Astria address using the Astria `dusk` network faucet +[here](https://faucet.sequencer.dusk-11.devnet.astria.org/). + +### Astria `dawn` Testnet + +Fund your Astria address using the Astria `dawn` network faucet +[here](https://faucet.sequencer.dawn-1.astria.org/). + +## Checking Account Balances + +To make the following commands easily copy and pasted, export your account +addresses to the environment: + +```bash +export ASTRIA_ADDRESS="" +export CELESTIA_ADDRESS="" +export FLAME_ADDRESS="" +export NOBLE_ADDRESS="" +export STRIDE_ADDRESS="" +``` + +### Check **Mainnet** Balances + + + +### Check **Testnet** Balances + + + +### Check **Devnet** Balances + + diff --git a/docs/bridging/devnet/bridge-to-astria-devnet.md b/docs/bridging/devnet/bridge-to-astria-devnet.md new file mode 100644 index 00000000..4a643448 --- /dev/null +++ b/docs/bridging/devnet/bridge-to-astria-devnet.md @@ -0,0 +1,48 @@ +# Bridging to the Astria `dusk` Devnet + +Bridging commands from Celestia and Noble testnets to the Astria `dusk` testnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +``` + +## Bridge to Astria + +### From Celestia + +```bash +celestia-appd tx ibc-transfer transfer transfer channel-159 $ASTRIA_ADDRESS 1000000utia --fees=420utia --from $CELESTIA_KEY_NAME --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 +``` + +### From Noble + +```bash +nobled tx ibc-transfer transfer transfer channel-231 $ASTRIA_ADDRESS 1000000uusdc --from $NOBLE_KEY_NAME --node https://noble-testnet-rpc.polkachu.com:443 --chain-id grand-1 +``` + +## Check Your Balances on Astria + +```bash +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.sequencer.dusk-11.devnet.astria.org/ +``` + +### View Transactions on [Mintscan](https://www.mintscan.io/) + +You can view your transactions by visiting +`https://www.mintscan.io/noble-testnet/address/` or +`https://www.mintscan.io/noble-testnet/address/`. You can +also go directly to [Mintscan](https://www.mintscan.io/) and search for the +`txhash` that is returned after sending your transaction, but it is recommended +to view your address transaction history as this will show if an acknowledgement +for your transfer was received. diff --git a/docs/bridging/devnet/bridge-to-flame-devnet.md b/docs/bridging/devnet/bridge-to-flame-devnet.md new file mode 100644 index 00000000..f85d55f0 --- /dev/null +++ b/docs/bridging/devnet/bridge-to-flame-devnet.md @@ -0,0 +1,92 @@ +# Bridging to Flame on `dusk` Devnet + +Bridging commands from Celestia and Noble testnets to the Astria `dusk` devnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](./overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +export FLAME_ADDRESS="" +``` + +## Bridge to Flame on `dusk` Devnet + +### From Celestia + +::: tip +There is no $TIA `BridgeLockAccount` configured for `dusk-11`. +::: + +### From Noble + +```bash +nobled tx ibc-transfer transfer \ + transfer \ + channel-231 \ + astria12saluecm8dd7hkutk83eavkl2p70lf5w7txezg \ + "100000uusdc" \ + --memo="{\"rollupDepositAddress\":\"$FLAME_ADDRESS\"}" \ + --chain-id="grand-1" \ + --from="grand-test-1" \ + --node=https://noble-testnet-rpc.polkachu.com:443 + --packet-timeout-height 0-0 +``` + +### nRIA from Astria + +```bash +astria-cli sequencer bridge-lock astria1yqdjnnmrp7w5ygwj0dkldsgzjhv5vcakp7yeu9 \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id astria-dusk-11 \ + --sequencer-url https://rpc.sequencer.dusk-11.devnet.astria.org \ + --fee-asset=nria --asset=nria +``` + +### USDC from Astria + +```bash +astria-cli sequencer bridge-lock astria12saluecm8dd7hkutk83eavkl2p70lf5w7txezg \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id astria-dusk-11 \ + --sequencer-url https://rpc.sequencer.dusk-11.devnet.astria.org \ + --fee-asset=nria --asset=transfer/channel-2/uusdc +``` + +## Check Your Balances on Flame + +### TIA + +```bash +cast balance $FLAME_ADDRESS --rpc-url https://rpc.flame.dusk-11.devnet.astria.org + +``` + +### USDC + + +```bash +cast balance $FLAME_ADDRESS --erc20 0x6e18cE6Ec3Fc7b8E3EcFca4fA35e25F3f6FA879a --rpc-url https://rpc.flame.dusk-11.devnet.astria.org + +``` + +## View Your Transactions + +Open the [Flame Block +Explorer](https://explorer.flame.dusk-11.devnet.astria.org) and search for your +Flame address to see your transactions. + +On the account page you can view your TIA balance directly. To view your USDC +balance, select the `Tokens` tab. diff --git a/docs/bridging/devnet/withdraw-from-astria-devnet.md b/docs/bridging/devnet/withdraw-from-astria-devnet.md new file mode 100644 index 00000000..93fc4ad0 --- /dev/null +++ b/docs/bridging/devnet/withdraw-from-astria-devnet.md @@ -0,0 +1,59 @@ + + +# Withdraw from the Astria `dusk` Devnet + +Withdrawal commands from Astria `dusk` devnet to Celestia and Noble testnets. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +``` + +## Withdraw from Astria + +### Astria to Celestia + +```bash +astria-cli sequencer ics20-withdrawal --amount 1000 --destination-chain-address=$CELESTIA_ADDRESS --source-channel channel-0 --private-key=$PRIV_KEY --sequencer-url=https://rpc.sequencer.dusk-11.devnet.astria.org --sequencer.chain-id astria-dusk-11 --asset transfer/channel-0/utia --fee-asset nria +``` + +### Astria to Noble + +```bash +astria-cli sequencer ics20-withdrawal --amount 1000 --destination-chain-address=$NOBLE_ADDRESS --source-channel channel-2 --private-key=$PRIV_KEY --sequencer-url=https://rpc.sequencer.dusk-11.devnet.astria.org --sequencer.chain-id astria-dusk-11 --asset transfer/channel-2/uusdc --fee-asset nria +``` + +### View Transactions on [Astrotrek](https://dusk.astrotrek.io/) + +Go to `https://dusk.astrotrek.io/account/?tab=transactions` +to see the withdrawal transactions. You can also search the returned transaction +hash directly in [Astrotrek](https://dusk.astrotrek.io/). + +You will also see the received transactions on +[Mintscan](#view-transactions-on-mintscan). + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 + +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 + +``` diff --git a/docs/bridging/devnet/withdraw-from-flame-devnet.md b/docs/bridging/devnet/withdraw-from-flame-devnet.md new file mode 100644 index 00000000..76c0fa07 --- /dev/null +++ b/docs/bridging/devnet/withdraw-from-flame-devnet.md @@ -0,0 +1,126 @@ +# Withdraw from Flame on `dusk` Devnet + +Make sure Foundry is installed: + +- See the [Foundry installation + docs](https://book.getfoundry.sh/getting-started/installation). + +Clone and build the `astria-bridge-contracts` repo: + +```bash +git clone git@github.com:astriaorg/astria-bridge-contracts.git +cd astria-bridge-contracts +forge build +cp local.env.example .env +``` + +Open the `.env` file and update the private key and destination chain addresses: + +```bash{1,19,23} +PRIVATE_KEY= + +RPC_URL="https://rpc.evm.dusk-11.devnet.astria.org/" + +# the `astriaBridgeSenderAddress` built into the astria-geth node +# in production, the private key for this address must NOT be known. +EVM_BRIDGE_ADDRESS=0xa7183eFD1e1fb81595009376f9643f54474933CD + +### contract call values + +# contract address for AstriaWithdrawer.sol +ASTRIA_WITHDRAWER="0xA58639fB5458e65E4fA917FF951C390292C24A15" + +# contract address for AstriaBridgeableERC20.sol +ASTRIA_BRIDGEABLE_ERC20_ADDRESS="0xa4f59B3E97EC22a2b949cB5b6E8Cd6135437E857" + +# if withdrawing to the sequencer, this must be set to +# the address to withdraw to on the sequencer +SEQUENCER_DESTINATION_CHAIN_ADDRESS= + +# if withdrawing to another chain via IBC, this must be set to +# the destination chain address to withdraw to +ORIGIN_DESTINATION_CHAIN_ADDRESS= + +# amount to withdraw, must be greater than 10^12 +AMOUNT=1000000000000 # 1 utia / uusdc + +# account to get erc20 balance of +MINT_TO=0x0b22C4b638A483a9A874713b7d10b9C900108168 +``` + +::: tip +In order to bridge out of Flame on `dusk` you must have a balance of native +funds to pay for gas. This is the `nria` bridged from Astria. +::: + +To make the following commands easy to copy and paste, export the `RPC_URL`: + +```bash +export RPC_URL="https://rpc.evm.dusk-11.devnet.astria.org/" +``` + +## To Astria + +### Withdraw TIA + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +### Withdraw USDC + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +## To Celestia + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## To Noble + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 + +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 + +``` diff --git a/docs/bridging/mainnet-alpha/bridge-to-astria-mainnet-alpha.md b/docs/bridging/mainnet-alpha/bridge-to-astria-mainnet-alpha.md new file mode 100644 index 00000000..43002f42 --- /dev/null +++ b/docs/bridging/mainnet-alpha/bridge-to-astria-mainnet-alpha.md @@ -0,0 +1,45 @@ +# Bridging to the Astria Mainnet Alpha + +Bridging commands from Celestia and Noble Mainnets to the Astria Mainnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +export OSMOSIS_KEY_NAME="" +export OSMOSIS_ADDRESS="" +export STRIDE_KEY_NAME="" +export STRIDE_ADDRESS="" +``` + +## Bridge to Astria + + + +## Check Your Balances on Astria + +```bash +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.astria.org/ +``` + +### View Transactions on [Mintscan](https://www.mintscan.io/) + +You can view your transactions by visiting the following: + +- `https://www.mintscan.io/celestia/address/` +- `https://www.mintscan.io/noble/address/` +- `https://www.mintscan.io/stride/address/` + +You can also go directly to [Mintscan](https://www.mintscan.io/) and search for +the `txhash` that is returned after sending your transaction, but it is +recommended to view your address transaction history as this will show if an +acknowledgement for your transfer was received. diff --git a/docs/bridging/mainnet-alpha/bridge-to-flame-mainnet-alpha.md b/docs/bridging/mainnet-alpha/bridge-to-flame-mainnet-alpha.md new file mode 100644 index 00000000..eee9ce61 --- /dev/null +++ b/docs/bridging/mainnet-alpha/bridge-to-flame-mainnet-alpha.md @@ -0,0 +1,101 @@ +# Bridging to Flame on Mainnet Alpha + +Bridging commands from Celestia and Noble Mainnets to the Astria Mainnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](./overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +export FLAME_ADDRESS="" +``` + +## Bridge to Flame + +### From Celestia + +```bash +celestia-appd tx ibc-transfer transfer \ + transfer \ + channel-48 \ + astria13vptdafyttpmlwppt0s844efey2cpc0mevy92p \ + "10000utia" \ + --fees=420utia \ + --memo="{\"rollupDepositAddress\":\"$FLAME_ADDRESS\"}" \ + --chain-id="celestia" \ + --from="$CELESTIA_KEY_NAME" \ + --node=https://celestia-rpc.polkachu.com:443 \ + --packet-timeout-height 0-0 +``` + +### From Noble + +```bash +nobled tx ibc-transfer transfer \ + transfer \ + channel-104 \ + astriacompat1eg8hhey0n4untdvqqdvlyl0e7zx8wfcaz3l6wu \ + "100000uusdc" \ + --memo="{\"rollupDepositAddress\":\"$FLAME_ADDRESS\"}" \ + --chain-id="noble-1" \ + --from="$NOBLE_KEY_NAME" \ + --node=https://noble-rpc.polkachu.com:443 \ + --packet-timeout-height 0-0 +``` + +### TIA from Astria + +```bash +astria-cli sequencer bridge-lock astria13vptdafyttpmlwppt0s844efey2cpc0mevy92p \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id astria \ + --sequencer-url https://rpc.astria.org/ \ + --fee-asset=transfer/channel-0/utia \ + --asset=transfer/channel-0/utia +``` + +### USDC from Astria + +```bash +astria-cli sequencer bridge-lock astria1eg8hhey0n4untdvqqdvlyl0e7zx8wfca48kglh \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id astria \ + --sequencer-url https://rpc.astria.org/ \ + --fee-asset=transfer/channel-0/utia \ + --asset=transfer/channel-1/uusdc +``` + +## Check Your Balances on Flame + +### TIA + +```bash +cast balance $FLAME_ADDRESS --rpc-url https://rpc.flame.astria.org +``` + +### USDC + + +```bash +cast balance $FLAME_ADDRESS --erc20 0x7Ac50eD64eB691366c979be04bD66EfD54067433 --rpc-url https://rpc.flame.astria.org +``` + +## View Your Transactions + +Open the [Flame Block Explorer](https://explorer.flame.astria.org) and +search for your Flame address to see your transactions. + +On the account page you can view your TIA balance directly. To view your USDC +balance, select the `Tokens` tab. diff --git a/docs/bridging/mainnet-alpha/withdraw-from-astria-mainnet-alpha.md b/docs/bridging/mainnet-alpha/withdraw-from-astria-mainnet-alpha.md new file mode 100644 index 00000000..8e7b45c4 --- /dev/null +++ b/docs/bridging/mainnet-alpha/withdraw-from-astria-mainnet-alpha.md @@ -0,0 +1,73 @@ + + +# Withdraw from the Astria Mainnet Alpha + +Withdrawal commands from Astria Mainnet to Celestia and Noble Mainnets. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +``` + +## Withdraw from Astria + +### Astria to Celestia + +```bash +astria-cli sequencer ics20-withdrawal \ + --amount 1000 \ + --destination-chain-address=$CELESTIA_ADDRESS \ + --source-channel channel-0 \ + --private-key=$PRIV_KEY \ + --sequencer-url=https://rpc.astria.org/ \ + --sequencer.chain-id astria \ + --asset transfer/channel-0/utia \ + --fee-asset transfer/channel-0/utia +``` + +### Astria to Noble + +```bash +astria-cli sequencer ics20-withdrawal \ + --amount 1000 \ + --destination-chain-address=$NOBLE_ADDRESS \ + --source-channel channel-1 \ + --private-key=$PRIV_KEY \ + --sequencer-url=https://rpc.astria.org/ \ + --sequencer.chain-id astria \ + --asset transfer/channel-1/uusdc \ + --fee-asset transfer/channel-0/utia +``` + +### View Transactions on [Astrotrek](https://astrotrek.io/) + +Go to `https://astrotrek.io/account/?tab=transactions` +to see the withdrawal transactions. You can also search the returned transaction +hash directly in [Astrotrek](https://astrotrek.io/). + +You will also see the received transactions on +[Mintscan](#view-transactions-on-mintscan). + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://celestia-rpc.polkachu.com:443 --chain-id celestia +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-rpc.polkachu.com:443 +``` diff --git a/docs/bridging/mainnet-alpha/withdraw-from-flame-mainnet-alpha.md b/docs/bridging/mainnet-alpha/withdraw-from-flame-mainnet-alpha.md new file mode 100644 index 00000000..d3a78b4c --- /dev/null +++ b/docs/bridging/mainnet-alpha/withdraw-from-flame-mainnet-alpha.md @@ -0,0 +1,126 @@ +# Withdraw from Flame on Mainnet Alpha + +Make sure Foundry is installed: + +- See the [Foundry installation + docs](https://book.getfoundry.sh/getting-started/installation). + +Clone and build the `astria-bridge-contracts` repo: + +```bash +git clone git@github.com:astriaorg/astria-bridge-contracts.git +cd astria-bridge-contracts +forge build +cp local.env.example .env +``` + +Open the `.env` file and update the private key and destination chain addresses: + + +```bash{1,19,23} +PRIVATE_KEY= + +RPC_URL="https://rpc.flame.astria.org/" + +# the `astriaBridgeSenderAddress` built into the astria-geth node +# in production, the private key for this address must NOT be known. +EVM_BRIDGE_ADDRESS=0xea9d2B36A562ee176c43312397c1b4279ee2343a + +### contract call values + +# contract address for AstriaWithdrawer.sol +ASTRIA_WITHDRAWER="0x77Af806d724699B3644F9CCBFD45CC999CCC3d49" + +# contract address for AstriaBridgeableERC20.sol +ASTRIA_BRIDGEABLE_ERC20_ADDRESS="0x6e18cE6Ec3Fc7b8E3EcFca4fA35e25F3f6FA879a" + +# if withdrawing to the sequencer, this must be set to +# the address to withdraw to on the sequencer +SEQUENCER_DESTINATION_CHAIN_ADDRESS= + +# if withdrawing to another chain via IBC, this must be set to +# the destination chain address to withdraw to +ORIGIN_DESTINATION_CHAIN_ADDRESS= + +# amount to withdraw, must be greater than 10^12 +AMOUNT=1000000000000 # 1 utia / uusdc + +# account to get erc20 balance of +MINT_TO=0x0b22C4b638A483a9A874713b7d10b9C900108168 +``` + +::: tip +In order to bridge out of Flame on Mainnet you must have a balance of native +funds to pay for gas. This is the `transfer/channel-0/utia` bridged from +Celestia. +::: + +To make the following commands easy to copy and paste, export the `RPC_URL`: + +```bash +export RPC_URL="https://rpc.flame.astria.org" +``` + +## To Astria + +### Withdraw TIA + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +### Withdraw USDC + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +## To Celestia + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## To Noble + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://celestia-rpc.polkachu.com:443 --chain-id celestia +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-rpc.polkachu.com:443 +``` diff --git a/docs/bridging/testnet/bridge-to-astria-testnet.md b/docs/bridging/testnet/bridge-to-astria-testnet.md new file mode 100644 index 00000000..ab302a26 --- /dev/null +++ b/docs/bridging/testnet/bridge-to-astria-testnet.md @@ -0,0 +1,48 @@ +# Bridging to the Astria `dawn` Testnet + +Bridging commands from Celestia and Noble testnets to the Astria `dawn` testnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +``` + +## Bridge to Astria + +### From Celestia + +```bash +celestia-appd tx ibc-transfer transfer transfer channel-160 $ASTRIA_ADDRESS 1000000utia --fees=420utia --from $CELESTIA_KEY_NAME --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 --packet-timeout-height 0-0 +``` + +### From Noble + +```bash +nobled tx ibc-transfer transfer transfer channel-232 $ASTRIA_ADDRESS 1000000uusdc --from $NOBLE_KEY_NAME --node https://noble-testnet-rpc.polkachu.com:443 --chain-id grand-1 --packet-timeout-height 0-0 +``` + +## Check Your Balances on Astria + +```bash +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.sequencer.dawn-1.astria.org/ +``` + +### View Transactions on [Mintscan](https://www.mintscan.io/) + +You can view your transactions by visiting +`https://www.mintscan.io/noble-testnet/address/` or +`https://www.mintscan.io/noble-testnet/address/`. You can +also go directly to [Mintscan](https://www.mintscan.io/) and search for the +`txhash` that is returned after sending your transaction, but it is recommended +to view your address transaction history as this will show if an acknowledgement +for your transfer was received. diff --git a/docs/bridging/testnet/bridge-to-flame-testnet.md b/docs/bridging/testnet/bridge-to-flame-testnet.md new file mode 100644 index 00000000..5a60ea71 --- /dev/null +++ b/docs/bridging/testnet/bridge-to-flame-testnet.md @@ -0,0 +1,101 @@ +# Bridging to Flame on `dawn` Testnet + +Bridging commands from Celestia and Noble testnets to the Astria `dawn` testnet. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](./overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +export FLAME_ADDRESS="" +``` + +## Bridge to Flame + +### From Celestia + +```bash +celestia-appd tx ibc-transfer transfer \ + transfer \ + channel-160 \ + astria1lepnry7tlpzvrukp5xej4v5wp532k2f94vxqnr \ + "10000utia" \ + --fees=420utia \ + --memo="{\"rollupDepositAddress\":\"$FLAME_ADDRESS\"}" \ + --chain-id="mocha-4" \ + --from="$CELESTIA_KEY_NAME" \ + --node=https://rpc-mocha.pops.one:443 \ + --packet-timeout-height 0-0 +``` + +### From Noble + +```bash +nobled tx ibc-transfer transfer \ + transfer \ + channel-232 \ + astria1u6ewl0tejz0df2l6tzc7k2degx6mqsjahldqxd \ + "100000uusdc" \ + --memo="{\"rollupDepositAddress\":\"$FLAME_ADDRESS\"}" \ + --chain-id="grand-1" \ + --from="$NOBLE_KEY_NAME" \ + --node=https://noble-testnet-rpc.polkachu.com:443 \ + --packet-timeout-height 0-0 +``` + +### TIA from Astria + +```bash +astria-cli sequencer bridge-lock astria1lepnry7tlpzvrukp5xej4v5wp532k2f94vxqnr \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id dawn-1 \ + --sequencer-url https://rpc.sequencer.dawn-1.astria.org/ \ + --fee-asset=transfer/channel-0/utia --asset=transfer/channel-0/utia +``` + +### USDC from Astria + +```bash +astria-cli sequencer bridge-lock astria1u6ewl0tejz0df2l6tzc7k2degx6mqsjahldqxd \ + --amount 10000 \ + --destination-chain-address $FLAME_ADDRESS \ + --private-key $PRIV_KEY \ + --sequencer.chain-id dawn-1 \ + --sequencer-url https://rpc.sequencer.dawn-1.astria.org/ \ + --fee-asset=transfer/channel-0/utia --asset=transfer/channel-1/uusdc +``` + +## Check Your Balances on Flame + +### TIA + +```bash +cast balance $FLAME_ADDRESS --rpc-url https://rpc.flame.dawn-1.astria.org + +``` + +### USDC + + +```bash +cast balance $FLAME_ADDRESS --erc20 0x6e18cE6Ec3Fc7b8E3EcFca4fA35e25F3f6FA879a --rpc-url https://rpc.flame.dawn-1.astria.org + +``` + +## View Your Transactions + +Open the [Flame Block Explorer](https://explorer.flame.dawn-1.astria.org) and +search for your Flame address to see your transactions. + +On the account page you can view your TIA balance directly. To view your USDC +balance, select the `Tokens` tab. diff --git a/docs/bridging/testnet/withdraw-from-astria-testnet.md b/docs/bridging/testnet/withdraw-from-astria-testnet.md new file mode 100644 index 00000000..e14e5ee9 --- /dev/null +++ b/docs/bridging/testnet/withdraw-from-astria-testnet.md @@ -0,0 +1,59 @@ + + +# Withdraw from the Astria `dawn` Devnet + +Withdrawal commands from Astria `dusk` devnet to Celestia and Noble testnets. + +You will need the `astria-cli`, `celestia-appd`, and `nobled` installed. Follow +the install steps [here](../overview.md#bridging-dependencies). + +You can export the following to make the commands below easily copy and +pastable. + +```bash +export ASTRIA_ADDRESS="" +export PRIV_KEY="" +export CELESTIA_KEY_NAME="" +export CELESTIA_ADDRESS="" +export NOBLE_KEY_NAME="" +export NOBLE_ADDRESS="" +``` + +## Withdraw from Astria + +### Astria to Celestia + +```bash +astria-cli sequencer ics20-withdrawal --amount 1000 --destination-chain-address=$CELESTIA_ADDRESS --source-channel channel-0 --private-key=$PRIV_KEY --sequencer-url=https://rpc.sequencer.dawn-1.astria.org/ --sequencer.chain-id dawn-1 --asset transfer/channel-0/utia --fee-asset transfer/channel-0/utia +``` + +### Astria to Noble + +```bash +astria-cli sequencer ics20-withdrawal --amount 1000 --destination-chain-address=$NOBLE_ADDRESS --source-channel channel-1 --private-key=$PRIV_KEY --sequencer-url=https://rpc.sequencer.dawn-1.astria.org/ --sequencer.chain-id dawn-1 --asset transfer/channel-1/uusdc --fee-asset transfer/channel-0/utia +``` + +### View Transactions on [Astrotrek](https://dawn.astrotrek.io/) + +Go to `https://dawn.astrotrek.io/account/?tab=transactions` +to see the withdrawal transactions. You can also search the returned transaction +hash directly in [Astrotrek](https://dawn.astrotrek.io/). + +You will also see the received transactions on +[Mintscan](#view-transactions-on-mintscan). + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 + +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 + +``` diff --git a/docs/bridging/testnet/withdraw-from-flame-testnet.md b/docs/bridging/testnet/withdraw-from-flame-testnet.md new file mode 100644 index 00000000..36ceff33 --- /dev/null +++ b/docs/bridging/testnet/withdraw-from-flame-testnet.md @@ -0,0 +1,127 @@ +# Withdraw from Flame on `dawn` Testnet + +Make sure Foundry is installed: + +- See the [Foundry installation + docs](https://book.getfoundry.sh/getting-started/installation). + +Clone and build the `astria-bridge-contracts` repo: + +```bash +git clone git@github.com:astriaorg/astria-bridge-contracts.git +cd astria-bridge-contracts +forge build +cp local.env.example .env +``` + +Open the `.env` file and update the private key and destination chain addresses: + +```bash{1,19,23} +PRIVATE_KEY= + +RPC_URL="https://rpc.flame.dawn-1.astria.org/" + +# the `astriaBridgeSenderAddress` built into the astria-geth node +# in production, the private key for this address must NOT be known. +EVM_BRIDGE_ADDRESS=0xea9d2B36A562ee176c43312397c1b4279ee2343a + +### contract call values + +# contract address for AstriaWithdrawer.sol +ASTRIA_WITHDRAWER="0x77Af806d724699B3644F9CCBFD45CC999CCC3d49" + +# contract address for AstriaBridgeableERC20.sol +ASTRIA_BRIDGEABLE_ERC20_ADDRESS="0x6e18cE6Ec3Fc7b8E3EcFca4fA35e25F3f6FA879a" + +# if withdrawing to the sequencer, this must be set to +# the address to withdraw to on the sequencer +SEQUENCER_DESTINATION_CHAIN_ADDRESS= + +# if withdrawing to another chain via IBC, this must be set to +# the destination chain address to withdraw to +ORIGIN_DESTINATION_CHAIN_ADDRESS= + +# amount to withdraw, must be greater than 10^12 +AMOUNT=1000000000000 # 1 utia / uusdc + +# account to get erc20 balance of +MINT_TO=0x0b22C4b638A483a9A874713b7d10b9C900108168 +``` + +::: tip +In order to bridge out of Flame on `dawn` you must have a balance of native +funds to pay for gas. This is the `transfer/channel-0/utia` bridged from +Celestia. +::: + +To make the following commands easy to copy and paste, export the `RPC_URL`: + +```bash +export RPC_URL="https://rpc.flame.dawn-1.astria.org" +``` + +## To Astria + +### Withdraw TIA + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +### Withdraw USDC + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToSequencer()" -vvvv +``` + +## To Celestia + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Celestia address. +::: + +```bash +forge script script/AstriaWithdrawer.s.sol:AstriaWithdrawerScript \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## To Noble + +::: info +Make sure the `ORIGIN_DESTINATION_CHAIN_ADDRESS` in your `.env` file is updated +to be your Noble address. +::: + +```bash +forge script script/AstriaBridgeableERC20.s.sol:AstriaBridgeableERC20Script \ + --rpc-url $RPC_URL --broadcast --sig "withdrawToIbcChain()" -vvvv +``` + +## Check your Balances on Celestia and Noble + +### Celestia Balance + +```bash +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 + +``` + +### Noble Balance + +```bash +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 + +``` diff --git a/docs/components/_bridge-to-astria-mainnet.md b/docs/components/_bridge-to-astria-mainnet.md new file mode 100644 index 00000000..ddedacf1 --- /dev/null +++ b/docs/components/_bridge-to-astria-mainnet.md @@ -0,0 +1,61 @@ + + +::: code-group + +```bash [From Celestia] +celestia-appd tx ibc-transfer transfer \ + transfer \ + channel-48 \ + $ASTRIA_ADDRESS \ + 1000000utia \ + --fees=420utia \ + --from $CELESTIA_KEY_NAME \ + --node=https://celestia-rpc.polkachu.com:443 \ + --chain-id celestia \ + --packet-timeout-height 0-0 +``` + +```bash [From Noble] +nobled tx ibc-transfer transfer \ + transfer \ + channel-104 \ + $ASTRIA_ADDRESS \ + 1000000uusdc \ + --from $NOBLE_KEY_NAME \ + --node https://noble-rpc.polkachu.com:443 \ + --chain-id noble-1 \ + --packet-timeout-height 0-0 +``` + +```bash [From Osmosis] +osmosisd tx ibc-transfer transfer \ + transfer \ + channel-85486 \ + $ASTRIA_ADDRESS \ + 1000000uusdc \ + --from $OSMOSIS_KEY_NAME \ + --node https://osmosis-rpc.polkachu.com:443 \ + --chain-id osmosis-1 \ + --packet-timeout-height 0-0 +``` + +```bash [From Stride] +strided tx ibc-transfer transfer \ + transfer \ + channel-285 \ + $ASTRIA_ADDRESS \ + "100000stutia" \ + --chain-id="stride-1" \ + --from=$STRIDE_KEY_NAME \ + --node=https://stride-rpc.polkachu.com:443 \ + --packet-timeout-height "0-0" \ + --fees=500ustrd +``` + +::: + + diff --git a/docs/components/_check-devnet-balances.md b/docs/components/_check-devnet-balances.md new file mode 100644 index 00000000..a3c1abd5 --- /dev/null +++ b/docs/components/_check-devnet-balances.md @@ -0,0 +1,37 @@ + + +::: code-group + +```bash [Astria] +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.sequencer.dusk-11.devnet.astria.org/ +``` + +```bash [Celestia] +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 +``` + +```bash [Noble] +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 +``` + +```bash [Osmosis] +osmosisd query bank balances $OSMOSIS_ADDRESS --node https://osmosis-testnet-rpc.polkachu.com:443 +``` + +```bash [Stride] +strided query bank balances $STRIDE_ADDRESS --node https://stride-testnet-rpc.polkachu.com:443 +``` + +```bash [Flame] +cast balance --rpc-url https://rpc.flame.dusk-11.devnet.astria.org $FLAME_ADDRESS +``` + +::: + + diff --git a/docs/components/_check-mainnet-balances.md b/docs/components/_check-mainnet-balances.md new file mode 100644 index 00000000..d889510f --- /dev/null +++ b/docs/components/_check-mainnet-balances.md @@ -0,0 +1,37 @@ + + +::: code-group + +```bash [Astria] +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.astria.org/ +``` + +```bash [Celestia] +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://celestia-rpc.polkachu.com:443 --chain-id celestia +``` + +```bash [Noble] +nobled query bank balances $NOBLE_ADDRESS --node https://noble-rpc.polkachu.com:443 +``` + +```bash [Osmosis] +osmosisd query bank balances $OSMOSIS_ADDRESS --node https://osmosis-rpc.polkachu.com:443 +``` + +```bash [Stride] +strided query bank balances $STRIDE_ADDRESS --node https://stride-rpc.polkachu.com:443 +``` + +```bash [Flame] +cast balance --rpc-url https://rpc.flame.astria.org $FLAME_ADDRESS +``` + +::: + + diff --git a/docs/components/_check-testnet-balances.md b/docs/components/_check-testnet-balances.md new file mode 100644 index 00000000..ead3b92f --- /dev/null +++ b/docs/components/_check-testnet-balances.md @@ -0,0 +1,37 @@ + + +::: code-group + +```bash [Astria] +astria-cli sequencer balance get $ASTRIA_ADDRESS --sequencer-url https://rpc.sequencer.dawn-1.astria.org/ +``` + +```bash [Celestia] +celestia-appd query bank balances $CELESTIA_ADDRESS --node=https://rpc-mocha.pops.one:443 --chain-id mocha-4 +``` + +```bash [Noble] +nobled query bank balances $NOBLE_ADDRESS --node https://noble-testnet-rpc.polkachu.com:443 +``` + +```bash [Osmosis] +osmosisd query bank balances $OSMOSIS_ADDRESS --node https://osmosis-testnet-rpc.polkachu.com:443 +``` + +```bash [Stride] +strided query bank balances $STRIDE_ADDRESS --node https://stride-testnet-rpc.polkachu.com:443 +``` + +```bash [Flame] +cast balance --rpc-url https://rpc.flame.dawn-1.astria.org $FLAME_ADDRESS +``` + +::: + + diff --git a/docs/components/_create-accounts.md b/docs/components/_create-accounts.md new file mode 100644 index 00000000..25d7c703 --- /dev/null +++ b/docs/components/_create-accounts.md @@ -0,0 +1,38 @@ + + +::: code-group + +```bash [Astria] +astria-cli sequencer account create +``` + +```bash [Celestia] +celestia-appd keys add +``` + +```bash [Noble] +nobled keys add +``` + +```bash [Osmosis] +osmosisd keys add +``` + +```bash [Stride] +strided keys add +``` + +```bash [Flame] +cast w new +``` + +::: + + diff --git a/docs/components/_install-nobled.md b/docs/components/_install-nobled.md new file mode 100644 index 00000000..ab5d5d20 --- /dev/null +++ b/docs/components/_install-nobled.md @@ -0,0 +1,28 @@ + + +::: code-group + +```bash [SSH] +git clone git@github.com:noble-assets/noble.git +cd noble +git fetch --all +git checkout v8.0.0-rc.2 +make build +cp build/nobled /usr/local/bin/nobled +``` + +```bash [HTTP] +git clone https://github.com/noble-assets/noble.git +cd noble +git fetch --all +git checkout v8.0.0-rc.2 +make build +cp build/nobled /usr/local/bin/nobled +``` + +::: + + diff --git a/docs/components/_install-osmosisd.md b/docs/components/_install-osmosisd.md new file mode 100644 index 00000000..316a2ab0 --- /dev/null +++ b/docs/components/_install-osmosisd.md @@ -0,0 +1,24 @@ + + +::: code-group + +```bash [SSH] +git clone git@github.com:osmosis-labs/osmosis.git +cd osmosis +make build +cp build/osmosisd /usr/local/bin/osmosisd +``` + +```bash [HTTP] +git clone https://github.com/osmosis-labs/osmosis.git +cd osmosis +make build +cp build/osmosisd /usr/local/bin/osmosisd +``` + +::: + + diff --git a/docs/components/_install-strided.md b/docs/components/_install-strided.md new file mode 100644 index 00000000..d975f9cb --- /dev/null +++ b/docs/components/_install-strided.md @@ -0,0 +1,24 @@ + + +::: code-group + +```bash [SSH] +git clone git@github.com:Stride-Labs/stride.git +cd stride +make build +cp build/strided /usr/local/bin/strided +``` + +```bash [HTTP] +git clone https://github.com/Stride-Labs/stride.git +cd stride +make build +cp build/strided /usr/local/bin/strided +``` + +::: + + diff --git a/docs/config.js b/docs/config.js index aa801325..8751c346 100644 --- a/docs/config.js +++ b/docs/config.js @@ -10,6 +10,7 @@ export const siteConfig = { currency_symbol: "TIA", }, bridging: { + ui_link: "https://bridge.astria.org", ibc_celestia_to_astria: "channel-48", ibc_astria_to_celestia: "channel-0", ibc_noble_to_astria: "channel-104", @@ -38,6 +39,7 @@ export const siteConfig = { currency_symbol: "TIA", }, bridging: { + ui_link: "https://astria-bridge-web-app.vercel.app/", ibc_mocha_to_dawn: "channel-160", ibc_dawn_to_mocha: "channel-0", ibc_grand_to_dawn: "channel-232", @@ -56,6 +58,7 @@ export const siteConfig = { currency_symbol: "nRIA", }, bridging: { + ui_link: "https://astria-bridge-web-app-develop.vercel.app/", ibc_mocha_to_dusk: "channel-159", ibc_dusk_to_mocha: "channel-0", ibc_grand_to_dusk: "channel-231", diff --git a/docs/flame/flame-mainnet.md b/docs/flame/flame-mainnet.md deleted file mode 100644 index ec4ba818..00000000 --- a/docs/flame/flame-mainnet.md +++ /dev/null @@ -1,91 +0,0 @@ - - - - -# Flame on Mainnet - -Flame is the EVM for Celestia Native DeFi. The information below is specifically -for Flame running on the Astria Mainnet. - -## EVM Information - -| Property | Value | -|-----|-----| -| Network Name | `{{config.flame.mainnet.info.network_name}}` | -| Chain ID | `{{config.flame.mainnet.info.chain_id}}` | -| RPC URL | {{config.mainnet.flame_rpc}} | -| Flame EVM Block Explorer | {{config.mainnet.flame_explorer}} | -| Native sequencer Asset | `{{config.flame.mainnet.info.native_asset}}` | -| Currency Symbol | `{{config.flame.mainnet.info.currency_symbol}}` | - -## Bridging - -| Property | Value | -|-----|-----| -| IBC Channel: mocha-4 -> dawn-1 | `{{config.flame.mainnet.bridging.ibc_celestia_to_astria}}` | -| IBC Channel: dawn-1 -> mocha-4 | `{{config.flame.mainnet.bridging.ibc_astria_to_celestia}}` | -| IBC Channel: grand-1 -> dawn-1 | `{{config.flame.mainnet.bridging.ibc_nobel_to_astria}}` | -| IBC Channel: dawn-1 -> grand-1 | `{{config.flame.mainnet.bridging.ibc_astria_to_nobel}}` | -| Astria Sequencer TIA Bridge Address | `{{config.flame.mainnet.bridging.sequencer_celestia_address}}` | -| Astria Sequencer USDC Bridge Address | `{{config.flame.mainnet.bridging.sequencer_nobel_address}}` | -| Flame TIA Withdrawal Address| `{{config.flame.mainnet.bridging.flame_tia_address}}` | -| Flame USDC Withdrawal Address| `{{config.flame.mainnet.bridging.flame_usdc_address}}` | - -## Adding to Metamask - -Follow Metamask's official documentation to [manually add a custom network.](https://support.metamask.io/hc/en-us/articles/360043227612-How-to-add-a-custom-network-RPC#h_01G63GGJ83DGDRCS2ZWXM37CV5) - -Your settings should be the following: - -| Property | Value | -| --- | --- | -| Network Name | `{{config.flame.mainnet.info.network_name}}` | -| New RPC URL | {{config.mainnet.flame_rpc}} | -| Chain ID | `{{config.flame.mainnet.info.chain_id}}` | -| Currency symbol | `{{config.flame.mainnet.info.currency_symbol}}` | -| Block Explorer | {{config.mainnet.flame_explorer}} | - -## Uniswap V3 - -| Name | Address | -|---|---| -| Descriptor Proxy Address | `{{config.mainnet.descriptorProxyAddress}}` | -| Multicall 2 Address | `{{config.mainnet.multicall2Address}}` | -| nft Position Descriptor Address | `{{config.mainnet.nftPositionDescriptorAddress}}` | -| nft Position Manager Address | `{{config.mainnet.nftPositionManagerAddress}}` | -| Proxy Admin Address | `{{config.mainnet.proxyAdminAddress}}` | -| Quoter V2 Address | `{{config.mainnet.quoterV2Address}}` | -| Swap Router 02 Address | `{{config.mainnet.swapRouter02Address}}` | -| Tick Lens Address | `{{config.mainnet.tickLensAddress}}` | -| v3 Core Factory Address | `{{config.mainnet.v3CoreFactoryAddress}}` | -| v3 Migrator Address | `{{config.mainnet.v3MigratorAddress}}` | -| v3 Staker Address | `{{config.mainnet.v3StakerAddress}}` | -| weth9 Address | `{{config.mainnet.weth9Address}}` | - -## Using Cast - -Set your `ETH_RPC_URL`: - -```bash -export ETH_RPC_URL=https://rpc.flame.astria.org -``` - -```bash -export REC_ADDR= -``` - -```bash -cast balance $REC_ADDR -``` - -```bash -cast send $REC_ADDR --value 10000000000000000000 --private-key -``` - -```bash -cast balance $REC_ADDR -``` diff --git a/docs/networks/devnet.md b/docs/networks/devnet.md index eb042af0..c9a24a79 100644 --- a/docs/networks/devnet.md +++ b/docs/networks/devnet.md @@ -22,6 +22,13 @@ const dusk = siteConfig.dusk | Celestia Signer Address | {{dusk.celestia_signer_address}} | | Celestia Dusk-{{dusk.num}} Namespace | {{dusk.celestia_namespace}} | +## Bridge Channels + +| Connected Network | Channel | Astria Dusk Channel | +|---|---|---| +| Celestia | `channel-159` | `channel-0` | +| Noble | `channel-231` | `channel-1` | + ## Dusk-{{dusk.num}} Service Versions | Service Name | Version | Source | diff --git a/docs/networks/mainnet-alpha.md b/docs/networks/mainnet-alpha.md index 247ce09d..75f75fe4 100644 --- a/docs/networks/mainnet-alpha.md +++ b/docs/networks/mainnet-alpha.md @@ -18,6 +18,15 @@ const mainnet = siteConfig.mainnet | Celestia Signer | {{mainnet.celestia_signer_address}} | | Celestia Mainnet Namespace | {{mainnet.celestia_namespace}} | +## Bridge Channels + +| Connected Network | Channel | Astria Channel | +|---|---|---| +| Celestia | `channel-48` | `channel-0` | +| Noble | `channel-104` | `channel-1` | +| Osmosis | `channel-85486` | `channel-2` | +| Stride | `channel-285` | `channel-3` | + ## Mainnet Service Versions | Service Name | Version | Source | diff --git a/docs/networks/testnet.md b/docs/networks/testnet.md index 4cee0373..cf01961d 100644 --- a/docs/networks/testnet.md +++ b/docs/networks/testnet.md @@ -20,6 +20,15 @@ const dawn = siteConfig.dawn | Celestia Signer | {{dawn.celestia_signer_address}} | | Celestia Dawn-{{dawn.num}} Namespace | {{dawn.celestia_namespace}} | +## Bridge Channels + +| Connected Network | Channel | Astria Dawn Channel | +|---|---|---| +| Celestia Mocha-4 | `channel-160` | `channel-0` | +| Noble | `channel-232` | `channel-1` | +| Stride | `channel-53` | `channel-2` | +| Osmosis | `channel-9186` | `channel-3` | + ## Dawn-{{ dawn.num }} Service Versions | Service Name | Version | Source |