contracts

type ABI uint8

type Call struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// Data are the arguments to contract's instantiation function.
	Data []byte `json:"data"`
	// Tokens that should be sent to the contract as part of the call.
	Tokens []types.BaseUnits `json:"tokens"`
}

type CallResult []byte

type ChangeUpgradePolicy struct {
	// ID is the unique instance identifier.
	ID InstanceID `json:"id"`
	// UpgradesPolicy is the updated upgrade policy.
	UpgradesPolicy Policy `json:"upgrades_policy"`
}

type Code struct {
	// ID is the unique code identifier.
	ID CodeID `json:"id"`
	// Hash is the code hash.
	Hash hash.Hash `json:"hash"`
	// ABI.
	ABI ABI `json:"abi"`
	// ABI sub-version.
	ABISubVersion uint32 `json:"abi_sv,omitempty"`
	// Uploader is the code uploader address.
	Uploader types.Address `json:"uploader"`
	// InstantiatePolicy is the policy on who is allowed to instantiate this code.
	InstantiatePolicy Policy `json:"instantiate_policy"`
}

type CodeID uint64

type CodeQuery struct {
	// ID is the code identifier.
	ID CodeID `json:"id"`
}

type CodeStorageQuery struct {
	// ID is the code identifier.
	ID CodeID `json:"id"`
}

type CodeStorageQueryResult struct {
	// Code is the stored contract code.
	Code []byte `json:"code"`
}

type CustomQuery struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// Data are the query method arguments.
	Data []byte `json:"data"`
}

type CustomQueryResult []byte

type Event struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// Data is the cbor serialized event data.
	Data []byte `json:"data,omitempty"`
}

type GasCosts struct {
	TxUpload              uint64 `json:"tx_upload"`
	TxUploadPerByte       uint64 `json:"tx_upload_per_byte"`
	TxInstantiate         uint64 `json:"tx_instantiate"`
	TxCall                uint64 `json:"tx_call"`
	TxUpgrade             uint64 `json:"tx_upgrade"`
	TxChangeUpgradePolicy uint64 `json:"tx_change_upgrade_policy"`

	SubcallDispatch uint64 `json:"subcall_dispatch"`

	WASMPublicStorageGetBase          uint64 `json:"wasm_public_storage_get_base"`
	WASMPublicStorageInsertBase       uint64 `json:"wasm_public_storage_insert_base"`
	WASMPublicStorageRemoveBase       uint64 `json:"wasm_public_storage_remove_base"`
	WASMPublicStorageKeyByte          uint64 `json:"wasm_public_storage_key_byte"`
	WASMPublicStorageValueByte        uint64 `json:"wasm_public_storage_value_byte"`
	WASMConfidentialStorageGetBase    uint64 `json:"wasm_confidential_storage_get_base"`
	WASMConfidentialStorageInsertBase uint64 `json:"wasm_confidential_storage_insert_base"`
	WASMConfidentialStorageRemoveBase uint64 `json:"wasm_confidential_storage_remove_base"`
	WASMConfidentialStorageKeyByte    uint64 `json:"wasm_confidential_storage_key_byte"`
	WASMConfidentialStorageValueByte  uint64 `json:"wasm_confidential_storage_value_byte"`
	WASMEnvQueryBase                  uint64 `json:"wasm_env_query_base"`

	WASMCryptoECDSARecover             uint64 `json:"wasm_crypto_ecdsa_recover"`
	WASMCryptoSignatureVerifyEd25519   uint64 `json:"wasm_crypto_signature_verify_ed25519"`
	WASMCryptoSignatureVerifySecp256k1 uint64 `json:"wasm_crypto_signature_verify_secp256k1"`
	WASMCryptoSignatureVerifySr25519   uint64 `json:"wasm_crypto_signature_verify_sr25519"`
	WASMCryptoX25519DeriveSymmetric    uint64 `json:"wasm_crypto_x25519_derive_symmetric"`
	WASMCryptoDeoxysIIBase             uint64 `json:"wasm_crypto_deoxysii_base"`
	WASMCryptoDeoxysIIByte             uint64 `json:"wasm_crypto_deoxysii_byte"`
	WASMCryptoRandomBytesBase          uint64 `json:"wasm_crypto_random_bytes_base"`
	WASMCryptoRandomBytesByte          uint64 `json:"wasm_crypto_random_bytes_byte"`
}

type Instance struct {
	// ID is the unique instance identifier.
	ID InstanceID `json:"id"`
	// CodeID is the identifier of code used by the instance.
	CodeID CodeID `json:"code_id"`
	// Creator is the instance creator address.
	Creator types.Address `json:"creator"`
	// UpgradesPolicy is the policy on who is allowed to upgrade this instance.
	UpgradesPolicy Policy `json:"upgrades_policy"`
}

type InstanceID uint64

type InstanceQuery struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
}

type InstanceRawStorageQuery struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`

	// StoreKind is type of store to query.
	StoreKind StoreKind `json:"store_kind"`

	// Limit is the maximum number of items per page.
	Limit uint64 `json:"limit,omitempty"`

	// Offset is the number of skipped items.
	Offset uint64 `json:"offset,omitempty"`
}

type InstanceRawStorageQueryResult struct {
	// Items is a list of key-value pairs in contract's public store.
	Items []InstanceStorageKeyValue `json:"items"`
}

type InstanceStorageKeyValue struct {
	Key   []byte
	Value []byte
	// contains filtered or unexported fields
}

type InstanceStorageQuery struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// Key is the storage key.
	Key []byte `json:"key"`
}

type InstanceStorageQueryResult struct {
	// Value is the storage value or nil if key doesn't exist.
	Value []byte `json:"value"`
}

type Instantiate struct {
	// CodeID is the identifier of code used by the instance.
	CodeID CodeID `json:"code_id"`
	// UpgradesPolicy is the policy on who is allowed to upgrade this instance.
	UpgradesPolicy Policy `json:"upgrades_policy"`
	// Data are the arguments to contract's instantiation function.
	Data []byte `json:"data"`
	// Tokens that should be sent to the contract as part of the instantiate call.
	Tokens []types.BaseUnits `json:"tokens"`
}

type InstantiateResult struct {
	// ID is the assigned instance identifier.
	ID InstanceID `json:"id"`
}

type Parameters struct {
	MaxCodeSize    uint32 `json:"max_code_size"`
	MaxStackSize   uint32 `json:"max_stack_size"`
	MaxMemoryPages uint32 `json:"max_memory_pages"`

	MaxWASMFunctions uint32 `json:"max_wasm_functions"`
	MaxWASMLocals    uint32 `json:"max_wasm_locals"`

	MaxSubcallDepth uint16 `json:"max_subcall_depth"`
	MaxSubcallCount uint16 `json:"max_subcall_count"`

	MaxResultSizeBytes                       uint32 `json:"max_result_size_bytes"`
	MaxQuerySizeBytes                        uint32 `json:"max_query_size_bytes"`
	MaxStorageKeySizeBytes                   uint32 `json:"max_storage_key_size_bytes"`
	MaxStorageValueSizeBytes                 uint32 `json:"max_storage_value_size_bytes"`
	MaxCryptoSignatureVerifyMessageSizeBytes uint32 `json:"max_crypto_signature_verify_message_size_bytes"`

	GasCosts GasCosts `json:"gas_costs"`
}

type Policy struct {
	Nobody   *struct{}      `json:"nobody,omitempty"`
	Address  *types.Address `json:"address,omitempty"`
	Everyone *struct{}      `json:"everyone,omitempty"`
}

type PublicKeyKind uint8

type PublicKeyQuery struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// Kind is the public key kind.
	Kind PublicKeyKind `json:"kind"`
}

type PublicKeyQueryResult struct {
	// Key is the public key.
	Key []byte `json:"key"`
	// Checksum of the key manager state.
	Checksum []byte `json:"checksum"`
	// Signature is the Sign(sk, (key || checksum)) from the key manager.
	Signature []byte `json:"signature"`
}

type StoreKind uint32

type Upgrade struct {
	// ID is the instance identifier.
	ID InstanceID `json:"id"`
	// CodeID is the identifier of updated code to be used by the instance.
	CodeID CodeID `json:"code_id"`
	// Data are the arguments to contract's instantiation function.
	Data []byte `json:"data"`
	// Tokens that should be sent to the contract as part of the upgrade call.
	Tokens []types.BaseUnits `json:"tokens"`
}

type Upload struct {
	// ABI.
	ABI ABI `json:"abi"`
	// InstantiatePolicy is the policy on Who is allowed to instantiate this code.
	InstantiatePolicy Policy `json:"instantiate_policy"`
	// Code is the compressed compiled contract code.
	Code []byte `json:"code"`
}

type UploadResult struct {
	// ID is the assigned code identifier.
	ID CodeID `json:"id"`
}

type V1 interface {
	client.EventDecoder

	// Upload generates a contracts.Upload transaction.
	Upload(abi ABI, instantiatePolicy Policy, code []byte) *client.TransactionBuilder

	// InstantiateRaw generates a contracts.Instantiate transaction.
	//
	// This method allows specifying an arbitrary data payload. If the contract is using the Oasis
	// ABI you can use the regular Call method as convenience since it will perform the CBOR
	// serialization automatically.
	InstantiateRaw(codeID CodeID, upgradesPolicy Policy, data []byte, tokens []types.BaseUnits) *client.TransactionBuilder

	// Instantiate generates a contracts.Instantiate transaction.
	//
	// This method will encode the specified data using CBOR as defined by the Oasis ABI.
	Instantiate(codeID CodeID, upgradesPolicy Policy, data any, tokens []types.BaseUnits) *client.TransactionBuilder

	// CallRaw generates a contracts.Call transaction.
	//
	// This method allows specifying an arbitrary data payload. If the contract is using the Oasis
	// ABI you can use the regular Call method as convenience since it will perform the CBOR
	// serialization automatically.
	CallRaw(id InstanceID, data []byte, tokens []types.BaseUnits) *client.TransactionBuilder

	// Call generates a contracts.Call transaction.
	//
	// This method will encode the specified data using CBOR as defined by the Oasis ABI.
	Call(id InstanceID, data any, tokens []types.BaseUnits) *client.TransactionBuilder

	// UpgradeRaw generates a contracts.Upgrade transaction.
	//
	// This method allows specifying an arbitrary data payload. If the contract is using the Oasis
	// ABI you can use the regular Upgrade method as convenience since it will perform the CBOR
	// serialization automatically.
	UpgradeRaw(id InstanceID, codeID CodeID, data []byte, tokens []types.BaseUnits) *client.TransactionBuilder

	// Upgrade generates a contracts.Upgrade transaction.
	//
	// This method will encode the specified data using CBOR as defined by the Oasis ABI.
	Upgrade(id InstanceID, codeID CodeID, data any, tokens []types.BaseUnits) *client.TransactionBuilder

	// ChangeUpgradePolicy generates a contracts.ChangeUpgradePolicy transaction.
	ChangeUpgradePolicy(id InstanceID, upgradesPolicy Policy) *client.TransactionBuilder

	// Code queries the given code information.
	Code(ctx context.Context, round uint64, id CodeID) (*Code, error)

	// CodeStorage queries the given code's storage.
	CodeStorage(ctx context.Context, round uint64, id CodeID) (*CodeStorageQueryResult, error)

	// Instance queries the given instance information.
	Instance(ctx context.Context, round uint64, id InstanceID) (*Instance, error)

	// InstanceStorage queries the given instance's public storage.
	InstanceStorage(ctx context.Context, round uint64, id InstanceID, key []byte) (*InstanceStorageQueryResult, error)

	// InstanceRawStorage returns the key-value pairs of contract instance storage.
	InstanceRawStorage(ctx context.Context, round uint64, id InstanceID, kind StoreKind, limit, offset uint64) (*InstanceRawStorageQueryResult, error)

	// PublicKey queries the given instance's public key.
	PublicKey(ctx context.Context, round uint64, id InstanceID, kind PublicKeyKind) (*PublicKeyQueryResult, error)

	// CustomRaw queries the given contract for a custom query.
	//
	// This method allows specifying an arbitrary data payload. If the contract is using the Oasis
	// ABI you can use the regular Custom method as convenience since it will perform the CBOR
	// serialization automatically.
	CustomRaw(ctx context.Context, round uint64, id InstanceID, data []byte) ([]byte, error)

	// Custom queries the given contract for a custom query.
	//
	// This method will encode the specified data using CBOR as defined by the Oasis ABI.
	Custom(ctx context.Context, round uint64, id InstanceID, data, rsp any) error

	// Parameters queries the EVM module parameters.
	Parameters(ctx context.Context, round uint64) (*Parameters, error)

	// GetEvents returns events emitted by the contract at the provided round.
	GetEvents(ctx context.Context, instanceID InstanceID, round uint64) ([]*Event, error)
}