feat(gnoland): Define and implement SponsorTransaction concept

contribs/gnodev/pkg/dev/node_test.go

@@ -247,9 +247,17 @@ func testingCallRealm(t *testing.T, node *Node, msgs ...vm.MsgCall) (*core_types
  RPCClient: node.Client(),
  }
 
+ signerInfo, err := signer.Info()
+ require.NoError(t, err)
+
+ acc, _, err := cli.QueryAccount(signerInfo.GetAddress())
+ require.NoError(t, err)
+
  txcfg := gnoclient.BaseTxCfg{
- GasFee: ugnot.ValueString(1000000), // Gas fee
- GasWanted: 2_000_000, // Gas wanted
+ GasFee: ugnot.ValueString(1000000), // Gas fee
+ GasWanted: 2_000_000, // Gas wanted
+ AccountNumber: acc.AccountNumber,
+ SequenceNumber: acc.Sequence,
  }
 
  // Set Caller in the msgs

docs/gno-tooling/cli/gnokey/state-changing-calls.md

@@ -88,6 +88,7 @@ The `addpkg` subcommmand uses the following flags and arguments:
 - `-gas-fee` - amount of GNOTs to pay per gas unit
 - `-chain-id` - id of the chain that we are sending the transaction to
 - `-remote` - specifies the remote node RPC listener address
+- `-sponsor` - bech32 address of the sponsor who pay gas fee for the transaction
 
 The `-pkgpath` and `-pkgdir` flags are unique to the `addpkg` subcommand, while
 `-broadcast`,`-send`, `-gas-wanted`, `-gas-fee`, `-chain-id`, and `-remote` are

gno.land/cmd/gnoland/testdata/sponsor_addpkg_for_existed_acc.txtar

@@ -0,0 +1,107 @@
+# Test for performing a sponsor addpkg transaction for an existed on-chain account (sponsoree)
+
+# Add new sponsor account
+adduser sponsor
+
+# Add new sponsoree account
+adduser sponsoree
+
+# start a new node
+gnoland start
+
+# Query sponsor's account before the transaction to check initial state
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",'
+stdout ' "public_key": null,'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "0"'
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsoree's account before the transaction to check initial state
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",'
+stdout ' "public_key": null,'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "0"'
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Sponsoree creates the transaction (deploy nft realm)
+gnokey maketx addpkg -pkgdir $WORK -pkgpath gno.land/r/${USER_ADDR_sponsoree}/nft -gas-fee 1000000ugnot -gas-wanted 20000000 -chainid=tendermint_test -sponsor=${USER_ADDR_sponsor} sponsoree
+cp stdout sponsor.tx
+
+# Sponsoree signs the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsoree
+cmpenv stdout sign.stdout.golden
+
+# Sponsor countersigns the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsor
+cmpenv stdout sign.stdout.golden
+
+# Sponsor broadcasts the transaction
+gnokey broadcast $WORK/sponsor.tx
+
+# Compare output to ensure the transaction was successful
+stdout OK!
+stdout 'GAS WANTED: 20000000'
+stdout 'GAS USED: \d+'
+stdout 'HEIGHT: \d+'
+stdout 'EVENTS: \[\]'
+stdout 'TX HASH: '
+
+# Query sponsor's account after the transaction to see gas deduction
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "9000000ugnot",' # 1000000 ugnot gas deducted from sponsor's balance
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsoree's account after the transaction
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",' # Sponsoree's balance remains the same (sponsor paid the fees)
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+
+-- nft.gno --
+package nft
+
+func Mint() string {
+ return "Minted NFT successful"
+}
+
+-- sign.stdout.golden --
+
+Tx successfully signed and saved to $WORK/sponsor.tx

gno.land/cmd/gnoland/testdata/sponsor_addpkg_for_nonexisted_acc.txtar

@@ -0,0 +1,98 @@
+# Test for performing a sponsor transaction for an non-existed on-chain account (sponsoree)
+
+# Add new sponsor account
+adduser sponsor
+
+# Create a sponsoree key (only the key, without creating the on-chain account)
+addkey sponsoree
+
+# start a new node
+gnoland start
+
+# Query sponsoree's account before
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",'
+stdout ' "public_key": null,'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "0"'
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsor's account before
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: null'
+
+# Sponsoree make a call transaction
+gnokey maketx addpkg -pkgdir $WORK -pkgpath gno.land/r/${USER_ADDR_sponsoree}/nft -gas-fee 1000000ugnot -gas-wanted 20000000 -chainid=tendermint_test -sponsor=${USER_ADDR_sponsor} sponsoree
+cp stdout sponsor.tx
+
+# Sponsoree signs the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsoree
+cmpenv stdout sign.stdout.golden
+
+# Sponsor countersigns the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsor
+cmpenv stdout sign.stdout.golden
+
+# Sponsor broadcasts the transaction
+gnokey broadcast $WORK/sponsor.tx
+
+# Compare output to ensure the transaction was successful
+stdout OK!
+stdout 'GAS WANTED: 20000000'
+stdout 'GAS USED: \d+'
+stdout 'HEIGHT: \d+'
+stdout 'EVENTS: \[\]'
+stdout 'TX HASH: '
+
+# Query sponsor's account after the transaction to see gas deduction
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "9000000ugnot",' # 1000000 ugnot gas deducted from sponsor's balance
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsoree's account after the transaction
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "",' # Sponsoree has no coins (sponsor paid the fees)
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",' # Sponsoree's new account number
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+
+-- nft.gno --
+package nft
+
+func Mint() string {
+ return "Minted NFT successful"
+}
+
+-- sign.stdout.golden --
+
+Tx successfully signed and saved to $WORK/sponsor.tx

gno.land/cmd/gnoland/testdata/sponsor_call_for_existed_acc.txtar

@@ -0,0 +1,111 @@
+# Test for performing a sponsor call transaction for an existed on-chain account (sponsoree)
+
+# Load the package from $WORK directory
+loadpkg gno.land/r/demo/nft $WORK
+
+# Add new sponsor account
+adduser sponsor
+
+# Add new sponsoree account
+adduser sponsoree
+
+# start a new node
+gnoland start
+
+# Query sponsor's account before the transaction to check initial state
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",'
+stdout ' "public_key": null,'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "0"'
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsoree's account before the transaction to check initial state
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",'
+stdout ' "public_key": null,'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "0"'
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+
+# Sponsoree creates the transaction (call to Mint in nft realm) 
+# Sponsor address is provided for sponsorship
+gnokey maketx call -pkgpath gno.land/r/demo/nft -chainid=tendermint_test -func Mint -gas-fee 1000000ugnot -gas-wanted 2000000 -sponsor=${USER_ADDR_sponsor} sponsoree
+cp stdout sponsor.tx
+
+# Sponsoree signs the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsoree
+cmpenv stdout sign.stdout.golden
+
+# Sponsor countersigns the transaction
+gnokey sign -tx-path $WORK/sponsor.tx -chainid "tendermint_test" -fetch-account-info=true sponsor
+cmpenv stdout sign.stdout.golden
+
+# Sponsor broadcasts the transaction
+gnokey broadcast $WORK/sponsor.tx
+
+# Compare output to ensure the transaction was successful
+stdout OK!
+stdout 'GAS WANTED: 2000000'
+stdout 'GAS USED: \d+'
+stdout 'HEIGHT: \d+'
+stdout 'EVENTS: \[\]'
+stdout 'TX HASH: '
+
+# Query sponsor's account after the transaction to see gas deduction
+gnokey query auth/accounts/${USER_ADDR_sponsor}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "9000000ugnot",' # 1000000 ugnot gas deducted from sponsor's balance
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+# Query sponsoree's account after the transaction
+gnokey query auth/accounts/${USER_ADDR_sponsoree}
+stdout 'height: 0'
+stdout 'data: {'
+stdout ' "BaseAccount": {'
+stdout ' "address": '
+stdout ' "coins": "10000000ugnot",' # Sponsoree's balance remains the same (sponsor paid the fees)
+stdout ' "public_key": {'
+stdout ' "@type": "/tm.PubKeySecp256k1",'
+stdout ' "value": '
+stdout ' },'
+stdout ' "account_number": "\d+",'
+stdout ' "sequence": "1"' # Sequence incremented after transaction
+stdout ' }'
+stdout '}'
+! stderr '.+' # Ensure no errors
+
+-- nft.gno --
+package nft
+
+func Mint() string {
+ return "Minted NFT successful"
+}
+
+-- sign.stdout.golden --
+
+Tx successfully signed and saved to $WORK/sponsor.tx