GXChain Docs

# Abi Parsing

The abi file is the external interface which defines the parameters of the action and the fields of the table ,can call the smart contract action. (Note: If there is no abi file, you can call the action by modifying the wallet client). When we call the action normally, we often fails to call the actions because some items of the abi file are missing. Therefore, this section of the tutorial parses the abi file. When you encounter an abi file error during the development of the contract, you can also locate the cause of the problem.

The abi file mainly contains four important fields: types、structs、actions、tables。

# types

The types field defines a custom alias for the type during contract development, for example:

// The contract has the following definition
typedef std::string mystring;
// @abi action
void appyourcom(mystring comname,std::string compub);
...

// The generated abi is defined as follows
"types": [{
	"new_type_name": "mystring",
	"type": "string"
	}
],

# structs

The structs field defines the table name, the type of the field it contains, the name of the action, and the type of the parameter it contains.

"structs": [{
	.......
	{
	  "name": "record",
	  "base": "",
	  "fields": [{
	      "name": "packet_issuer",
	      "type": "uint64"
	    },{
	      "name": "accounts",
	      "type": "account[]"
	    }
	  ]
	},{
	  "name": "issue",
	  "base": "",
	  "fields": [{
	      "name": "pubkey",
	      "type": "string"
	    },{
	      "name": "number",
	      "type": "uint64"
	    }
	  ]
	}
	......
}

# actions

The actions field includes the defined external interface name, type (same name), payable (bool type, whether the action is attached to the asset)

"actions": [{
	"name": "issue",
	"type": "issue",
	"payable": true
},
.....
{
	"name": "close",
	"type": "close",
	"payable": false
}
],

# tables

The table field includes the defined multi-index table, name (table name), index_type (primary key index type, i64), key_names (primary key member name), key_types (primary key member type), type (table name)

"tables": [{
	"name": "packet",
	"index_type": "i64",
	"key_names": [
		"issuer"
	],
	"key_types": [
		"uint64"
	],
	"type": "packet"
	}
	.....
],

← Move Table →