Skip to content

Latest commit

 

History

History
139 lines (91 loc) · 9.3 KB

scripts.md

File metadata and controls

139 lines (91 loc) · 9.3 KB
Raw

Scripts

Prerequisites

Install: near-cli-rs

Build: cargo build --package gas-station --target wasm32-unknown-unknown --release --no-default-features

Initialization sequence

NOTE: ensure network-config testnet is set to appropriate value for all calls (either mainnet or testnet)

  1. Deploy

    • ensure canhazgas.testnet, "signer_contract_id", and "oracle_id" (from pyth NEAR docs) fields are updated to the appropriate values (name of your gas station contract and chain signatures contract)
    • For mainnet, use new instead of new_debug and the file path may be different
    near contract deploy canhazgas.testnet use-file ./target/near/gas_station/gas_station.wasm with-init-call new_debug json-args '{"oracle_id":"pyth-oracle.testnet","signer_contract_id":"v2.nft.kagi.testnet"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' network-config testnet sign-with-legacy-keychain send

  2. Add supported deposit assets.

    [!IMPORTANT] In this contract, all oracle price identifiers must be paired with USD (e.g. NEAR/USD, ETH/USD, etc.).

    • ensure the hatchet.testnet, oracle_asset_id, and canhazgas.testnet fields are updated to the appropriate values

    Native NEAR

    near contract call-function as-transaction canhazgas.testnet add_accepted_local_asset json-args '{"asset_id":"Native","decimals":24,"oracle_asset_id":"3gnSbT7bhoTdGkFVZc1dW1PvjreWzpUNUD5ppXwv1N59"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as hatchet.testnet network-config testnet sign-with-legacy-keychain send

  3. Add foreign chains.

    BSC Testnet

    near contract call-function as-transaction canhazgas.testnet add_foreign_chain json-args '{"chain_id":"97","oracle_asset_id":"EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw","transfer_gas":"21000","fee_rate":["120","100"],"decimals":18}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

    ETH Sepolia Testnet

    near contract call-function as-transaction canhazgas.testnet add_foreign_chain json-args '{"chain_id":"11155111","oracle_asset_id":"EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw","transfer_gas":"21000","fee_rate":["120","100"],"decimals":18}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

    Base Testnet

    near contract call-function as-transaction canhazgas.testnet add_foreign_chain json-args '{"chain_id":"84532","oracle_asset_id":"EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw","transfer_gas":"21000","fee_rate":["120","100"],"decimals":18}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

    Arbitrum Sepolia Testnet

    near contract call-function as-transaction canhazgas.testnet add_foreign_chain json-args '{"chain_id":"421614","oracle_asset_id":"EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw","transfer_gas":"21000","fee_rate":["120","100"],"decimals":18}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

    Optimism Sepolia Testnet

    near contract call-function as-transaction canhazgas.testnet add_foreign_chain json-args '{"chain_id":"11155420","oracle_asset_id":"EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw","transfer_gas":"21000","fee_rate":["120","100"],"decimals":18}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

  4. Add paymaster.

    Add administrator if necessary

    • ensure the hatchet.testnet, and canhazgas.testnet fields are updated to the appropriate values
    near contract call-function as-transaction canhazgas.testnet add_administrator json-args '{"account_id":"hatchet.testnet"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

    Transfer chain key NFT - if NFT already minted

    near contract call-function as-transaction v2.nft.kagi.testnet ckt_approve_call json-args '{"token_id":"1","account_id":"canhazgas.testnet","msg":"{\"is_paymaster\":true}"}' prepaid-gas '100.0 Tgas' attached-deposit '1 yoctoNEAR' sign-as hatchet.testnet network-config testnet sign-with-legacy-keychain send

    Mark key for use as paymaster

    • NOTE: call this once per chain_id you wish to add.
    • change the balance to the balance of the account on a chain at the time it is added as a paymaster for that chain. The balance must be specified in units of the smallest indivisible unit of gas token (i.e. wei on Ethereum mainnet). To find the account associated with the NFT from the previous step, call nft_key.near->ckt_public_key_for(token_id) and then convert it into an address using something like ethers_core::utils::raw_public_key_to_address. For example:

      multichain-gas-station-contract/lib/src/foreign_address.rs

      Lines 20 to 22 in 0ad3dd6

      pub fn from_raw_public_key(key_bytes: impl AsRef<[u8]>) -> Self {
      ethers_core::utils::raw_public_key_to_address(&key_bytes.as_ref()[1..]).into()
      }
    • ensure the chain_id, token_id, and canhazgas.testnet fields are updated to the appropriate values
    near contract call-function as-transaction canhazgas.testnet add_paymaster json-args '{"chain_id":"97","balance":"100000000000000000000","nonce":0,"token_id":"1"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

Selected Pyth price identifiers:

Feed Identifier (base58) Identifier (hex)
NEAR/USD 3gnSbT7bhoTdGkFVZc1dW1PvjreWzpUNUD5ppXwv1N59 27e867f0f4f61076456d1a73b14c7edc1cf5cef4f4d6193a33424288f11bd0f4
ETH/USD EdVCmQ9FSPcVe5YySXDPCRmc8aDQLKJ9xvYBMZPie1Vw ca80ba6dc32e08d06f1aa886011eed1d77c77be9eb761cc10d72b7d0a2fd57a6
BNB/USD GwzBgrXb4PG59zjce24SF2b9JXbLEjJJTBkmytuEZj1b ecf553770d9b10965f8fb64771e93f5690a182edc32be4a3236e0caaa6e0581a
ARB/USD 5HRrdmghsnU3i2u5StaKaydS7eq3vnKVKwXMzCNKsc4C
OP/USD 4o4CUwzFwLqCvmA5x1G4VzoZkAhAcbiuiYyjWX1CVbY2

Signing sequence

  1. Create transaction sequence

    near contract call-function as-transaction canhazgas.testnet create_transaction json-args '{"transaction_rlp_hex":"0xe7618222628204d28204d2825208940f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f8204d280c0","use_paymaster":true,"token_id":"0"}' prepaid-gas '100.0 Tgas' attached-deposit '0.5 NEAR' sign-as hatchet.testnet network-config testnet sign-with-legacy-keychain send

  2. Sign each transaction (perform 1+ times)

    near contract call-function as-transaction canhazgas.testnet sign_next json-args '{"id":"0"}' prepaid-gas '300.0 Tgas' attached-deposit '0 NEAR' sign-as hatchet.testnet network-config testnet sign-with-legacy-keychain send

Maintenance

Re-sync paymaster nonce

The nonce should be set to the number of transactions that have already been sent from this account. This means that the nonce should be set to 0 if the paymaster account has not yet sent any transactions, to 1 if the paymaster has already sent one transaction, etc.

near contract call-function as-transaction canhazgas.testnet set_paymaster_nonce json-args '{"chain_id":"97","index":0,"nonce":16}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send

Set paymaster balance

This number will only decrease on the contract's side unless it is regularly "topped-up" by an authorized entity. Set this value to the maximum amount of foreign tokens the gas station contract can send to fund gas for user transactions.

near contract call-function as-transaction canhazgas.testnet set_paymaster_balance json-args '{"chain_id":"97","index":0,"balance":"134800000000000000"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as canhazgas.testnet network-config testnet sign-with-legacy-keychain send