Skip to main content


The SDK used by Himalia to interact with the contract part of the chain needs to start a node before proceeding with the subsequent execution process.

For nodes with pallet-contracts function, we recommend Europa as an alternative to nodes. For more information, please refer to Europa's Document.

Europa can be easily installed and used with the following commands:

git install --recurse-submodules --force --lockedeuropa --tmp

On the other hand, you can also use Patract’s testnet Jupiter, or the contract testnet provided by Parity [Canvas-node]( canvas-node.git)


PatractGo relies on GSRPC. The Go version of Himalia project is called go-patract

After installing PatractGo, you can use the following methods to quickly deploy and call a contract. For the complete case, please refer to transfer_test

Deploy the contract#

// read the code wasm from filecodeBytes, err := ioutil.ReadFile("/path/to/contracts.wasm")if err != nil {    return err}// create the apicApi, err := rpc.NewContractAPI(env.URL())
// read the abi(metadata) for contractmetaBz, err := ioutil.ReadFile("/path/to/contracts_metadata.json")cApi.WithMetaData(metaBz)
// create context with from auth, like Alicectx := api.NewCtx(context.Background()).WithFrom(authKey)
// put code_, err = cApi.Native().PutCode(ctx, codeBytes)
codeHash := readCodeHash() // get code hash
var codeBz []byte
if err := cApi.Native().Cli.GetStorageLatest(&codeBz,    "Contracts", "PristineCode",    []byte(codeHash), nil); err != nil {        return err    }
var endowment uint64 = 1000000000000
// Instantiate_, contractAccount, err := cApi.Instantiate(ctx,    types.NewCompactBalance(endowment),    types.NewCompactGas(test.DefaultGas),    contracts.CodeHashERC20,    types.NewU128(totalSupply),)

Call contract#

rpc call#

Call total_supply to get the current total supply.

var res types.U128
err := a.CallToRead(ctx,    &res,    a.ContractAccountID,    []string{"total_supply"},)

Transaction call#

Call transfer to transfer a fund.

toParam := struct {    Address AccountID}{    Address: to,}
valueParam := struct {    Value U128}{    Value: amt,}
return a.CallToExec(ctx,    a.ContractAccountID,    types.NewCompactBalance(0),    types.NewCompactGas(test.DefaultGas),    []string{"transfer"},    toParam, valueParam,)


PatractPy relies on py-substrate-interface The Python version of the Himalia project is called [py-patract]( -patract)


pip3 install -U patract-interface

Can be used in python script

from patractinterface import ContractFactory, ContractAPI
// ... So something ...

Quick use#

import osfrom substrateinterface import SubstrateInterface, Keypairfrom patractinterface.contract import ContractAPI, ContractFactoryfrom import ContractObserver
def main():    # use [europa]( as test node endpoint, notice `type_registry` should set correctly.    substrate=SubstrateInterface(url='ws://', type_registry_preset="default", type_registry={'types': {'LookupSource': 'MultiAddress'}})    # load deployer key    alice = Keypair.create_from_uri('//Alice')    bob = Keypair.create_from_uri('//Bob')    # 1. load a contract from Wasm file and metadata.json file (Those files is complied by [ink!](    # in this example, we use `ink/example/erc20` contract as example.    contract = ContractFactory.create_from_file(            substrate=substrate, # should provide a subtrate endpoint            code_file= os.path.join(os.path.dirname(__file__), 'res', 'erc20.wasm'),            metadata_file= os.path.join(os.path.dirname(__file__), 'res', 'erc20.json')        )    # upload code to chain directly    res = contract.put_code(alice)    print("update code hash{} res:{}".format(contract.code_hash.hex(), res.is_succes))    # 2. instantiate the uploaded code as a contract instance    erc20_ins =, 1000000 * (10 ** 15), endowment=2*10**10, gas_limit=20000000000, deployment_salt="0x12")    # 2.1 create a observer to listen event    observer = ContractObserver(erc20_ins.contract_address, erc20_ins.metadata, substrate)    # 3. send a transfer call for this contract    res = erc20_ins.transfer(alice, bob.ss58_address, 100000, gas_limit=20000000000)    print('transfer res', res.is_succes)
    def on_transfer(num, evt):        print("on_transfer in {} : {} {} {}".format(num, evt['from'], evt['to'], evt['value']))
    def on_approval(num, evt):        print("on_approval in {} : {} {} {}".format(num, evt['owner'], evt['spender'], evt['value']))    # 4 set event callback     observer.scanEvents(handlers={        'Transfer': on_transfer,        'Approve': on_approval    })
if __name__ == "__main__":    main()    pass