tezos-protocol-012-Psithaca 20.1

This module defines identifiers for two basic types of contracts. It also specifies how to compute originated contract's hash from origination nonce.

type t = private

| Implicit of Tezos_protocol_environment_012_Psithaca.Signature.Public_key_hash.t
| Originated of Contract_hash.t

A contract is simply an account on the blockchain ledger. There are two types of contracts:

implicit contracts represent accounts of users of the blockchain;
originated are special accounts with a Michelson script attached to them. Every time a transaction is sent to an originated account, its associated script is run in order to trigger some action in response.

An implicit account is identified by the hash of the public key which was used to create it. The owner of the corresponding private key is the holder of the account. An originated contract's hash is derived from its origination nonce (see below).

type contract = t

include Tezos_protocol_environment_012_Psithaca.Compare.S
  with type t := contract

val (=) : contract -> contract -> bool

val (<>) : contract -> contract -> bool

val (<) : contract -> contract -> bool

val (<=) : contract -> contract -> bool

val (>=) : contract -> contract -> bool

val (>) : contract -> contract -> bool

val compare : contract -> contract -> int

val equal : contract -> contract -> bool

val max : contract -> contract -> contract

val min : contract -> contract -> contract

val public_key_hash_in_memory_size : Cache_memory_helpers.sint

val in_memory_size : t -> Cache_memory_helpers.sint

Implicit contracts

val implicit_contract : 
  Tezos_protocol_environment_012_Psithaca.Signature.Public_key_hash.t ->
  contract

val is_implicit : 
  contract ->
  Tezos_protocol_environment_012_Psithaca.Signature.Public_key_hash.t option

Originated contracts

type origination_nonce

Originated contracts handles are crafted from the hash of the operation that triggered their origination (and nothing else). As a single operation can trigger several originations, the corresponding handles are forged from a deterministic sequence of nonces, initialized with the hash of the operation.

val originated_contract : origination_nonce -> contract

val originated_contracts : 
  since:origination_nonce ->
  until:origination_nonce ->
  contract list

val initial_origination_nonce : 
  Tezos_protocol_environment_012_Psithaca.Operation_hash.t ->
  origination_nonce

val incr_origination_nonce : origination_nonce -> origination_nonce

val is_originated : contract -> Contract_hash.t option

Human readable notation

type Tezos_protocol_environment_012_Psithaca.Error_monad.error +=

| Invalid_contract_notation of string

val to_b58check : contract -> string

val of_b58check : 
  string ->
  contract Tezos_protocol_environment_012_Psithaca.Error_monad.tzresult

val pp : 
  Tezos_protocol_environment_012_Psithaca.Format.formatter ->
  contract ->
  unit

val pp_short : 
  Tezos_protocol_environment_012_Psithaca.Format.formatter ->
  contract ->
  unit

Serializers

val encoding : contract Tezos_protocol_environment_012_Psithaca.Data_encoding.t

val origination_nonce_encoding : 
  origination_nonce Tezos_protocol_environment_012_Psithaca.Data_encoding.t

val rpc_arg : contract Tezos_protocol_environment_012_Psithaca.RPC_arg.arg

module Index : Storage_description.INDEX with type t = t

package tezos-protocol-012-Psithaca

Implicit contracts

Originated contracts

Human readable notation

Serializers