This package implements the generic DA interface defined in go-da
The generic DA interface defines how DA implementations can submit, retrieve and validate blobs.
The Avail DA implementation connects to a local Avail-light-node instance using the given config and allows using Avail as the DA layer.
The implementation calls the corresponding Avail node api docs methods.
Get retrieves blobs referred to by their ids.
The implementation calls Get endpoint on the Avail-light-node API.
Submit submits blobs and returns their ids and proofs.
The implementation calls Submit endpoint on the Avail-light-node API.
clone the repo
https://github.com/availproject/avail.git
go to root folder
cd avail
checkout to the following branch
git checkout v1.9.0.3
run node
cargo run --locked --release -- --dev
clone the repo
https://github.com/availproject/avail-light-bootstrap.git
go to root folder
cd avail-light-bootstrap
run node
cargo run --release
clone the repo
https://github.com/availproject/avail-light.git
go to root folder
cd avail-light
create a configuration file touch config.yaml in the root directory & put following content.
http_server_host = '127.0.0.1'
http_server_port = 8000
port = 38000
tcp_port_reuse = false
autonat_only_global_ips = false
autonat_throttle = 1
autonat_retry_interval = 10
autonat_refresh_interval = 30
autonat_boot_delay = 5
identify_protocol = '/avail_kad/id/1.0.0'
identify_agent = 'avail-light-client/rust-client'
bootstraps = [["12D3KooWStAKPADXqJ7cngPYXd2mSANpdgh1xQ34aouufHA2xShz", "/ip4/127.0.0.1/udp/39000"]]
bootstrap_period = 300
relays = []
full_node_ws = ['ws://127.0.0.1:9944']
confidence = 92.0
avail_path = 'avail_path'
log_level = 'INFO'
log_format_json = false
ot_collector_endpoint = 'http://otelcollector.avail.tools:4317'
disable_rpc = false
disable_proof_verification = false
dht_parallelization_limit = 20
put_batch_size = 1000
query_proof_rpc_parallel_tasks = 8
max_cells_per_rpc = 30
threshold = 5000
kad_record_ttl = 86400
publication_interval = 43200
replication_interval = 10800
replication_factor = 20
connection_idle_timeout = 30
query_timeout = 60
query_parallelism = 3
caching_max_peers = 1
disjoint_query_paths = false
max_kad_record_number = 2400000
max_kad_record_size = 8192
max_kad_provided_keys = 1024
app_id=1
run node
cargo run --release -- --network local -c config.yaml --clean
generate avail key pair if not configured by adding the following seed phrase in identity.toml in root directory
avail_secret_seed_phrase = 'bottom drive obey lake curtain smoke basket hold race lonely fit walk//Alice'
Now that you have a da node and light client running, we are ready to build and run our Cosmos-SDK blockchain (here we have taken gm application)
go to the root directory and install rollkit by adding the following lines to go.mod
replace github.com/cosmos/cosmos-sdk => github.com/rollkit/cosmos-sdk v0.50.1-rollkit-v0.11.9-no-fraud-proofs
and run
go mod tidy
start your rollup
create one script file (init-local.sh) in root folder
touch init-local.sh
add the following script to the script file (init-local.sh) or you can get the script from here
to make use of avail as a da layer,
git clone https://github.com/rollkit/avail-da.git
cd avail-da
go run ./cmd/avail-da/main.go
note: make sure that port address(serving avail-da) must be the rollkit.da_address in the script file
run the rollup chain
go to root of the gm repo and run
bash init-local.sh
list your keys
gmd keys list --keyring-backend test
You should see an output like the following
- address: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
name: gm-key-2
pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AiRf1Vxwcuunu1yjPpSUPxW85Q9NhM1y0Dg3ozOEGUto"}'
type: local
- address: gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
name: gm-key
pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A9hnpPl0G6VOBijJNheFXvJDg1O7NszzA8innoXF81N5"}'
type: localNow we can test by sending the transaction by sending amount from one account to another
gmd tx bank send [from_key_or_address] [to_address] [amount] [flags]
ex:
gmd tx bank send gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69 11stake --chain-id gm --keyring-backend test
You'll be prompted to accept the transaction:
auth_info:
fee:
amount: []
gas_limit: "200000"
granter: ""
payer: ""
signer_infos: []
tip: null
body:
extension_options: []
memo: ""
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "11"
denom: stake
from_address: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
to_address: gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
non_critical_extension_options: []
timeout_height: "0"
signatures: []
confirm transaction before signing and broadcasting [y/N]:
Type y if you'd like to confirm and sign the transaction. Then, you'll see the confirmation:
confirm transaction before signing and broadcasting [y/N]: y
code: 0
codespace: ""
data: ""
events: []
gas_used: "0"
gas_wanted: "0"
height: "0"
info: ""
logs: []
raw_log: ""
timestamp: ""
tx: null
txhash: 130EA420F2373C88F6191E1D203CEF272B666BE283316A17BC8B02FBABCBA1C9
you can query the tx using using
gmd q tx <hash>
ex:
gmd q tx 130EA420F2373C88F6191E1D203CEF272B666BE283316A17BC8B02FBABCBA1C9
then you'll see
code: 0
codespace: ""
data: 12260A242F636F736D6F732E62616E6B2E763162657461312E4D736753656E64526573706F6E736 5
events:
- attributes:
- index: true
key: fee
value: ""
- index: true
key: fee_payer
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
type: tx
- attributes:
- index: true
key: acc_seq
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl/0
type: tx
- attributes:
- index: true
key: signature
value: y2ZU5c/CLcJpKbT8e2uZZz3T5buO/ efa9yNuODgLBd90xt4c6ErNf2H1OQnZerdpdez1H3kWdLyk769Pb2Sisg==
type: tx
- attributes:
- index: true
key: action
value: /cosmos.bank.v1beta1.MsgSend
- index: true
key: sender
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
- index: true
key: module
value: bank
- index: true
key: msg_index
value: "0"
type: message
- attributes:
- index: true
key: spender
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
- index: true
key: amount
value: 11stake
- index: true
key: msg_index
value: "0"
type: coin_spent
- attributes:
- index: true
key: receiver
value: gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
- index: true
key: amount
value: 11stake
- index: true
key: msg_index
value: "0"
type: coin_received
- attributes:
- index: true
key: recipient
value: gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
- index: true
key: sender
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
- index: true
key: amount
value: 11stake
- index: true
key: msg_index
value: "0"
type: transfer
- attributes:
- index: true
key: sender
value: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
- index: true
key: msg_index
value: "0"
type: message
gas_used: "61687"
gas_wanted: "200000"
height: "103"
info: ""
logs: []
raw_log: ""
timestamp: "2024-01-08T07:14:14Z"
tx:
'@type': /cosmos.tx.v1beta1.Tx
auth_info:
fee:
amount: []
gas_limit: "200000"
granter: ""
payer: ""
signer_infos:
- mode_info:
single:
mode: SIGN_MODE_DIRECT
public_key:
'@type': /cosmos.crypto.secp256k1.PubKey
key: AiRf1Vxwcuunu1yjPpSUPxW85Q9NhM1y0Dg3ozOEGUto
sequence: "0"
tip: null
body:
extension_options: []
memo: ""
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "11"
denom: stake
from_address: gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
to_address: gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
non_critical_extension_options: []
timeout_height: "0"
signatures:
- y2ZU5c/CLcJpKbT8e2uZZz3T5buO/ efa9yNuODgLBd90xt4c6ErNf2H1OQnZerdpdez1H3kWdLyk769Pb2Sisg==
txhash: 130EA420F2373C88F6191E1D203CEF272B666BE283316A17BC8B02FBABCBA1C9
then query the bank balances
gmd query bank balances gm1ffdft5ku0qw67eypavgyltjqj54yraaa4uj8pl
you can see
balances:
- amount: "9999999999999999999999989"
denom: stake
pagination:
total: "1"
query the balance of other key
gmd query bank balances gm1r4g9lleykkw6mjdpmp6e0tgusymh4sa2swcw69
you can see
balances:
- amount: "10000000000000000000000011"
denom: stake
pagination:
total: "1"
With this You've built a local rollup that posts to a local avail light node