mirror of
https://github.com/nspcc-dev/neo-go.git
synced 2024-11-24 19:30:34 +00:00
*: extend basic testing chain documentation
Save some time for developers who are not familiar with RPC server unit-test structure. Signed-off-by: Anna Shaleva <shaleva.ann@nspcc.ru>
This commit is contained in:
Anna Shaleva
parent
2b758c53eb
commit
40dda9f524
3 changed files with 67 additions and 27 deletions
|
|
@ -29,11 +29,13 @@ var (
|
|||
pathToInternalContracts = filepath.Join("..", "..", "internal", "contracts")
|
||||
)
|
||||
|
||||
// TestCreateBasicChain generates "../rpc/testdata/testblocks.acc" file which
|
||||
// TestCreateBasicChain generates "pkg/services/rpcsrv/testdata/testblocks.acc" file which
|
||||
// contains data for RPC unit tests. It also is a nice integration test.
|
||||
// To generate new "../rpc/testdata/testblocks.acc", follow the steps:
|
||||
// To generate new "pkg/services/rpcsrv/testdata/testblocks.acc", follow the steps:
|
||||
// 1. Set saveChain down below to true
|
||||
// 2. Run tests with `$ make test`
|
||||
// 3. Update relevant constants and variables used by RPC server unit tests
|
||||
// in "pkg/services/rpcsrv/server_test.go".
|
||||
func TestCreateBasicChain(t *testing.T) {
|
||||
const saveChain = false
|
||||
|
||||
|
|
|
|||
|
|
@ -89,12 +89,10 @@ func getUnitTestChainWithCustomConfig(t testing.TB, enableOracle bool, enableNot
|
|||
}
|
||||
|
||||
func getTestBlocks(t *testing.T) []*block.Block {
|
||||
// File "./testdata/testblocks.acc" was generated by function core.TestCreateBasicChain
|
||||
// ("neo-go/pkg/core/helper_test.go").
|
||||
// To generate new "./testdata/testblocks.acc", follow the steps:
|
||||
// 1. Rename the function
|
||||
// 2. Add specific test-case into "neo-go/pkg/core/blockchain_test.go"
|
||||
// 3. Run tests with `$ make test`
|
||||
// File "./testdata/testblocks.acc" was generated by unit-test
|
||||
// [core.TestCreateBasicChain] ("neo-go/pkg/core/basic_chain_test.go"). To
|
||||
// generate new "./testdata/testblocks.acc", follow the steps provided in the
|
||||
// unit-test documentation.
|
||||
f, err := os.Open("testdata/testblocks.acc")
|
||||
require.Nil(t, err)
|
||||
br := io.NewBinReaderFromIO(f)
|
||||
|
|
|
|||
|
|
@ -73,30 +73,70 @@ type rpcTestCase struct {
|
|||
check func(t *testing.T, e *executor, result any)
|
||||
}
|
||||
|
||||
const genesisBlockHash = "0f8fb4e17d2ab9f3097af75ca7fd16064160fb8043db94909e00dd4e257b9dc4"
|
||||
const testContractHash = "449fe8fbd4523072f5e3a4dfa17a494c119d4c08"
|
||||
const deploymentTxHash = "bbb8ec059dd320dc9de5a8fb8c75351d8e369fca0256f7a6bdb623dcf71861ed"
|
||||
|
||||
// Constants and variables below are taken from the logs generated by
|
||||
// [core.TestCreateBasicChain]. These constants and variables should be updated manually
|
||||
// on basic chain regeneration. Please, refer to TestCreateBasicChain documentation
|
||||
// to learn about basic testing chain generation.
|
||||
const (
|
||||
verifyContractHash = "06ed5314c2e4cb103029a60b86d46afa2fb8f67c"
|
||||
verifyContractAVM = "VwIAQS1RCDBwDBTunqIsJ+NL0BSPxBCOCPdOj1BIskrZMCQE2zBxaBPOStkoJATbKGlK2SgkBNsol0A="
|
||||
verifyWithArgsContractHash = "6261b3bf753bdc3d24c1327a23fd891e1c8a7ccd"
|
||||
nnsContractHash = "450d1918a72fef97b48096bfec8d749961deef55"
|
||||
nnsToken1ID = "6e656f2e636f6d"
|
||||
nfsoContractHash = "914246ab7888ba4eb3ddebc9cb5433c2edcc1671"
|
||||
nfsoToken1ID = "7e244ffd6aa85fb1579d2ed22e9b761ab62e3486"
|
||||
storageContractHash = "ebc0c16a76c808cd4dde6bcc063f09e45e331ec7"
|
||||
faultedTxHashLE = "82279bfe9bada282ca0f8cb8e0bb124b921af36f00c69a518320322c6f4fef60"
|
||||
faultedTxBlock uint32 = 23
|
||||
invokescriptContractAVM = "VwIADBQBDAMOBQYMDQIODw0DDgcJAAAAAErZMCQE2zBwaEH4J+yMqiYEEUAMFA0PAwIJAAIBAwcDBAUCAQAOBgwJStkwJATbMHFpQfgn7IyqJgQSQBNA"
|
||||
block20StateRootLE = "394e20adf99a6ba160df7351770dfb193ee8af174b7b3ed45f4e2ae8c43694e8"
|
||||
// genesisBlockHash is an LE hash of genesis block in basic testing chain.
|
||||
genesisBlockHash = "0f8fb4e17d2ab9f3097af75ca7fd16064160fb8043db94909e00dd4e257b9dc4"
|
||||
// testContractHash is an LE hash of NEP-17 "Rubl" contract deployed at block #2
|
||||
// of basic testing chain.
|
||||
testContractHash = "449fe8fbd4523072f5e3a4dfa17a494c119d4c08"
|
||||
// deploymentTxHash is an LE hash of transaction that deploys NEP-17 "Rubl"
|
||||
// contract at block #2 of basic testing chain.
|
||||
deploymentTxHash = "bbb8ec059dd320dc9de5a8fb8c75351d8e369fca0256f7a6bdb623dcf71861ed"
|
||||
// verifyContractHash is an LE hash of "Verify" contract deployed at block #7 of
|
||||
// basic testing chain.
|
||||
verifyContractHash = "06ed5314c2e4cb103029a60b86d46afa2fb8f67c"
|
||||
// verifyContractAVM is a base64-encoded AVM of "Verify" contract deployed at block #7 of
|
||||
// basic testing chain.
|
||||
verifyContractAVM = "VwIAQS1RCDBwDBTunqIsJ+NL0BSPxBCOCPdOj1BIskrZMCQE2zBxaBPOStkoJATbKGlK2SgkBNsol0A="
|
||||
// verifyWithArgsContractHash is an LE hash of "VerifyWithArgs" contract deployed
|
||||
// at block #10 of basic testing chain.
|
||||
verifyWithArgsContractHash = "6261b3bf753bdc3d24c1327a23fd891e1c8a7ccd"
|
||||
// nnsContractHash is an LE hash of NEP-11 non-divisible "examples/nft-nd-nns"
|
||||
// contract deployed at block #11 of basic testing chain.
|
||||
nnsContractHash = "450d1918a72fef97b48096bfec8d749961deef55"
|
||||
// nnsToken1ID is a hex-encoded ID of the first NEP-11 NNS token minted at block
|
||||
// #14 of basic testing chain.
|
||||
nnsToken1ID = "6e656f2e636f6d"
|
||||
// nfsoContractHash is an LE hash of NEP-11 divisible "examples/nft-d" ("NeoFS
|
||||
// Object") contract deployed at block #17 of basic testing chain.
|
||||
nfsoContractHash = "914246ab7888ba4eb3ddebc9cb5433c2edcc1671"
|
||||
// nfsoToken1ID is a hex-encoded ID of the first NEP-11 NFSO token minted at
|
||||
// block #18 of basic testing chain.
|
||||
nfsoToken1ID = "7e244ffd6aa85fb1579d2ed22e9b761ab62e3486"
|
||||
// storageContractHash is an LE hash of "Storage" contract deployed at block #22
|
||||
// of basic testing chain.
|
||||
storageContractHash = "ebc0c16a76c808cd4dde6bcc063f09e45e331ec7"
|
||||
// faultedTxHashLE is an LE hash of FAULTed transaction accepted at block #23 of
|
||||
// basic testing chain.
|
||||
faultedTxHashLE = "82279bfe9bada282ca0f8cb8e0bb124b921af36f00c69a518320322c6f4fef60"
|
||||
// faultedTxBlock is the number of block of basic testing chain that contains
|
||||
// FAULTed transaction.
|
||||
faultedTxBlock uint32 = 23
|
||||
// invokescriptContractAVM is a base64-encoded AVM of
|
||||
// "pkg/internal/basicchain/testdata/invokescript_contract.go" contract that is
|
||||
// not yet deployed to the testing basic chain.
|
||||
invokescriptContractAVM = "VwIADBQBDAMOBQYMDQIODw0DDgcJAAAAAErZMCQE2zBwaEH4J+yMqiYEEUAMFA0PAwIJAAIBAwcDBAUCAQAOBgwJStkwJATbMHFpQfgn7IyqJgQSQBNA"
|
||||
// block20StateRootLE is an LE stateroot of block #20 of basic testing chain.
|
||||
block20StateRootLE = "394e20adf99a6ba160df7351770dfb193ee8af174b7b3ed45f4e2ae8c43694e8"
|
||||
)
|
||||
|
||||
var (
|
||||
nnsHash, _ = util.Uint160DecodeStringLE(nnsContractHash)
|
||||
nfsoHash, _ = util.Uint160DecodeStringLE(nfsoContractHash)
|
||||
// nnsHash is a hash of NEP-11 non-divisible "examples/nft-nd-nns" contract
|
||||
// deployed at block #11 of basic testing chain.
|
||||
nnsHash, _ = util.Uint160DecodeStringLE(nnsContractHash)
|
||||
// nfsoHash is a hash of NEP-11 divisible "examples/nft-d" ("NeoFS
|
||||
// Object") contract deployed at block #17 of basic testing chain.
|
||||
nfsoHash, _ = util.Uint160DecodeStringLE(nfsoContractHash)
|
||||
// nfsoToken1ContainerID contains data used to mint the first NFSO token in the
|
||||
// basic testing chain (see [nfsoToken1ID] documentation).
|
||||
nfsoToken1ContainerID = util.Uint256{1, 2, 3}
|
||||
nfsoToken1ObjectID = util.Uint256{4, 5, 6}
|
||||
// nfsoToken1ContainerID contains data used to mint the first NFSO token in the
|
||||
// basic testing chain (see [nfsoToken1ID] documentation).
|
||||
nfsoToken1ObjectID = util.Uint256{4, 5, 6}
|
||||
)
|
||||
|
||||
var rpcFunctionsWithUnsupportedStatesTestCases = map[string][]rpcTestCase{
|
||||
|
|
|
|||
Loading…
Reference in a new issue