(**************************************************************************) (* *) (* Copyright (c) 2014 - 2016. *) (* Dynamic Ledger Solutions, Inc. *) (* *) (* All rights reserved. No warranty, explicit or implicit, provided. *) (* *) (**************************************************************************) open Data_encoding open Tezos_context let error_encoding = let open Data_encoding in describe ~description: "The full list of error is available with \ the global RPC `/errors`" (conv (fun exn -> `A (List.map json_of_error exn)) (function `A exns -> List.map error_of_json exns | _ -> []) json) let wrap_tzerror encoding = let open Data_encoding in union [ case (obj1 (req "ok" encoding)) (function Ok x -> Some x | _ -> None) (fun x -> Ok x) ; case (obj1 (req "error" error_encoding)) (function Error x -> Some x | _ -> None) (fun x -> Error x) ; ] module Constants = struct let cycle_length custom_root = RPC.service ~description: "Cycle length" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "cycle length" int32) RPC.Path.(custom_root / "constants" / "cycle_length") let voting_period_length custom_root = RPC.service ~description: "Length of the voting period" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "voting period length" int32) RPC.Path.(custom_root / "constants" / "voting_period_length") let time_before_reward custom_root = RPC.service ~description: "Time before reward" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "time before reward" Period.encoding) RPC.Path.(custom_root / "constants" / "time_before_reward") let time_between_slots custom_root = RPC.service ~description: "Time between slots" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "time between slots" Period.encoding) RPC.Path.(custom_root / "constants" / "time_between_slots") let first_free_mining_slot custom_root = RPC.service ~description: "First free mining slot" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "first free mining slot" int32) RPC.Path.(custom_root / "constants" / "first_free_mining_slot") let max_signing_slot custom_root = RPC.service ~description: "Max signing slot" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "max signing slot" int31) RPC.Path.(custom_root / "constants" / "max_signing_slot") let instructions_per_transaction custom_root = RPC.service ~description: "Instructions per transaction" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "instructions per transaction" int31) RPC.Path.(custom_root / "constants" / "instructions_per_transaction") let proof_of_work_threshold custom_root = RPC.service ~description: "Stamp threshold" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "proof_of_work threshold" int31) RPC.Path.(custom_root / "constants" / "proof_of_work_threshold") let errors custom_root = RPC.service ~description: "Schema for all the RPC errors from this protocol version" ~input: empty ~output: json_schema RPC.Path.(custom_root / "constants" / "errors") let bootstrap custom_root = RPC.service ~description: "Hardcoded predefined keys and contract" ~input: empty ~output: (list Bootstrap.account_encoding) RPC.Path.(custom_root / "constants" / "bootstrap_keys") end module Context = struct let level custom_root = RPC.service ~description: "Detailled level information for the current block" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "detailled level info" Level.encoding) RPC.Path.(custom_root / "context" / "level") let next_level custom_root = RPC.service ~description: "Detailled level information for the next block" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "detailled level info" Level.encoding) RPC.Path.(custom_root / "context" / "next_level") module Nonce = struct type nonce_info = | Revealed of Nonce.t | Missing of Nonce_hash.t | Forgotten let nonce_encoding = union [ case (obj1 (req "nonce" Nonce.encoding)) (function Revealed nonce -> Some nonce | _ -> None) (fun nonce -> Revealed nonce) ; case (obj1 (req "hash" Nonce_hash.encoding)) (function Missing nonce -> Some nonce | _ -> None) (fun nonce -> Missing nonce) ; case empty (function Forgotten -> Some () | _ -> None) (fun () -> Forgotten) ; ] let get custom_root = RPC.service ~description: "Info about the nonce of a previous block." ~input: empty ~output: (wrap_tzerror nonce_encoding) RPC.Path.(custom_root / "context" / "nonce" /: Raw_level.arg) let hash custom_root = RPC.service ~description: "Hash of the current block's nonce." ~input: empty ~output: (wrap_tzerror @@ describe ~title: "nonce hash" Nonce_hash.encoding) RPC.Path.(custom_root / "context" / "nonce") end module Key = struct let public_key_hash_arg = let construct = Ed25519.Public_key_hash.to_b48check in let destruct hash = match Ed25519.Public_key_hash.of_b48check hash with | exception _ -> Error "Cannot parse public key hash" | public_key_hash -> Ok public_key_hash in RPC.Arg.make ~descr:"A public key hash" ~name: "public_key_hash" ~construct ~destruct () let pk_encoding = (obj2 (req "hash" Ed25519.public_key_hash_encoding) (req "public_key" Ed25519.public_key_encoding)) let list custom_root = RPC.service ~description: "List the known public keys" ~input: empty ~output: (wrap_tzerror @@ list pk_encoding) RPC.Path.(custom_root / "context" / "keys") let get custom_root = RPC.service ~description: "Fetch the stored public key" ~input: empty ~output: (wrap_tzerror @@ pk_encoding) RPC.Path.(custom_root / "context" / "keys" /: public_key_hash_arg ) end (*-- Contracts ---------------------------------------------------------------*) module Contract = struct let balance custom_root = RPC.service ~description: "Access the balance of a contract." ~input: empty ~output: (wrap_tzerror Tez.encoding) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "balance") let manager custom_root = RPC.service ~description: "Access the manager of a contract." ~input: empty ~output: (wrap_tzerror Ed25519.public_key_hash_encoding) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "manager") let delegate custom_root = RPC.service ~description: "Access the delegate of a contract, if any." ~input: empty ~output: (wrap_tzerror (option Ed25519.public_key_hash_encoding)) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "delegate") let counter custom_root = RPC.service ~description: "Access the counter of a contract, if any." ~input: empty ~output: (wrap_tzerror int32) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "counter") let spendable custom_root = RPC.service ~description: "Tells if the contract tokens can be spent by the manager." ~input: empty ~output: (wrap_tzerror bool) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "spendable") let delegatable custom_root = RPC.service ~description: "Tells if the contract delegate can be changed." ~input: empty ~output: (wrap_tzerror bool) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "delegatable") let script custom_root = RPC.service ~description: "Access the code and data of the contract." ~input: empty ~output: (wrap_tzerror Script.encoding) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "script") let assets custom_root = RPC.service ~description: "Access the assets of the contract." ~input: empty ~output: (wrap_tzerror Asset.Map.encoding) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg / "assets") type info = { manager: public_key_hash ; balance: Tez.t ; spendable: bool ; delegate: bool * public_key_hash option ; script: Script.t ; assets: Asset.Map.t ; counter: int32 ; } let get custom_root = RPC.service ~description: "Access the complete status of a contract." ~input: empty ~output: (wrap_tzerror @@ conv (fun {manager;balance;spendable;delegate;script;assets;counter} -> (manager,balance,spendable,delegate,script,assets,counter)) (fun (manager,balance,spendable,delegate,script,assets,counter) -> {manager;balance;spendable;delegate;script;assets;counter}) @@ obj7 (req "manager" Ed25519.public_key_hash_encoding) (req "balance" Tez.encoding) (req "spendable" bool) (req "delegate" @@ obj2 (req "setable" bool) (opt "value" Ed25519.public_key_hash_encoding)) (dft "script" Script.encoding No_script) (req "assets" Asset.Map.encoding) (req "counter" int32)) RPC.Path.(custom_root / "context" / "contracts" /: Contract.arg) let list custom_root = RPC.service ~description: "All existing contracts (including non-empty default contracts)." ~input: empty ~output: (wrap_tzerror @@ list Contract.encoding) RPC.Path.(custom_root / "context" / "contracts") end end (*-- Helpers ----------------------------------------------------------------*) module Helpers = struct let minimal_timestamp custom_root = RPC.service ~description: "Minimal timestamp for the next block." ~input: (obj1 (opt "priority" int31)) ~output: (wrap_tzerror @@ obj1 (req "timestamp" Timestamp.encoding)) RPC.Path.(custom_root / "helpers" / "minimal_timestamp") let typecheck_code custom_root = RPC.service ~description: "Typecheck a piece of code in the current context" ~input: Script.code_encoding ~output: (wrap_tzerror Script_ir_translator.type_map_enc) RPC.Path.(custom_root / "helpers" / "typecheck_code") let typecheck_tagged_data custom_root = RPC.service ~description: "Check that some tagged data expression is well formed \ and well typed in the current context" ~input: (obj1 (req "data" Script.expr_encoding)) ~output: (wrap_tzerror empty) RPC.Path.(custom_root / "helpers" / "typecheck_tagged_data") let typecheck_untagged_data custom_root = RPC.service ~description: "Check that some untagged data expression is well formed \ and of a given type in the current context" ~input: (obj2 (req "data" Script.expr_encoding) (req "type" Script.expr_encoding)) ~output: (wrap_tzerror empty) RPC.Path.(custom_root / "helpers" / "typecheck_untagged_data") let hash_data custom_root = RPC.service ~description: "Computes the hash of some (untagged) data expression \ using the same algorithm as script instruction H" ~input: (obj1 (req "data" Script.expr_encoding)) ~output: (wrap_tzerror @@ obj1 (req "hash" string)) RPC.Path.(custom_root / "helpers" / "hash_data") let level custom_root = RPC.service ~description: "..." ~input: (obj1 (opt "offset" int32)) ~output: (wrap_tzerror @@ describe ~title: "block level and cycle information" Level.encoding) RPC.Path.(custom_root / "helpers" / "level" /: Raw_level.arg) let levels custom_root = RPC.service ~description: "Levels of a cycle" ~input: empty ~output: (wrap_tzerror @@ describe ~title: "levels of a cycle" (list Level.encoding)) RPC.Path.(custom_root / "helpers" / "levels" /: Cycle.arg) module Rights = struct let slots_range_encoding = (obj3 (opt "max_priority" int31) (opt "first_level" Raw_level.encoding) (opt "last_level" Raw_level.encoding)) let slot_encoding = (obj3 (req "level" Raw_level.encoding) (req "priority" int31) (opt "timestamp" Timestamp.encoding)) let mining_rights custom_root = RPC.service ~description: "List gelegates allowed to mine for the next level, \ ordered by priority." ~input: (obj1 (opt "max_priority" int31)) ~output: (wrap_tzerror @@ obj2 (req "level" Raw_level.encoding) (req "mining_rights" (list (obj2 (req "delegate" Ed25519.public_key_hash_encoding) (req "timestamp" Timestamp.encoding))))) RPC.Path.(custom_root / "helpers" / "rights" / "mining") let mining_rights_for_level custom_root = RPC.service ~description: "List delegate allowed to mine for a given level, \ ordered by priority." ~input: (obj1 (opt "max_priority" int31)) ~output: (wrap_tzerror @@ obj2 (req "level" Raw_level.encoding) (req "delegates" (list Ed25519.public_key_hash_encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "mining" / "level" /: Raw_level.arg ) let mining_levels custom_root = RPC.service ~description: "List level for which we might computed mining rights." ~input: empty ~output: (wrap_tzerror @@ obj1 (req "levels" (list Raw_level.encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "mining" / "level" ) let mining_rights_for_delegate custom_root = RPC.service ~description: "Future mining rights for a given delegate." ~input: slots_range_encoding ~output: (wrap_tzerror (Data_encoding.list slot_encoding)) RPC.Path.(custom_root / "helpers" / "rights" / "mining" / "delegate" /: Context.Key.public_key_hash_arg ) let mining_delegates custom_root = RPC.service ~description: "List delegates with mining rights." ~input: empty ~output: (wrap_tzerror @@ obj1 (req "delegates" (list Ed25519.public_key_hash_encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "mining" / "delegate" ) let endorsement_rights custom_root = RPC.service ~description: "List delegates allowed to endorse for the current block." ~input: (obj1 (opt "max_priority" int31)) ~output: (wrap_tzerror @@ obj2 (req "level" Raw_level.encoding) (req "delegates" (list Ed25519.public_key_hash_encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "endorsement") let endorsement_rights_for_level custom_root = RPC.service ~description: "List delegates allowed to endorse blocks for a given level." ~input: (obj1 (opt "max_priority" int31)) ~output: (wrap_tzerror @@ obj2 (req "level" Raw_level.encoding) (req "delegates" (list Ed25519.public_key_hash_encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "endorsement" / "level" /: Raw_level.arg ) let endorsement_levels custom_root = RPC.service ~description: "List level for which we might computed endorsement rights." ~input: empty ~output: (wrap_tzerror @@ obj1 (req "levels" (list Raw_level.encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "endorsement" / "level" ) let endorsement_rights_for_delegate custom_root = RPC.service ~description: "Compute endorsement rights for a given delegate." ~input: slots_range_encoding ~output: (wrap_tzerror @@ Data_encoding.list slot_encoding) RPC.Path.(custom_root / "helpers" / "rights" / "endorsement" / "delegate" /: Context.Key.public_key_hash_arg ) let endorsement_delegates custom_root = RPC.service ~description: "List delegates with endorsement rights." ~input: empty ~output: (wrap_tzerror @@ obj1 (req "delegates" (list Ed25519.public_key_hash_encoding))) RPC.Path.(custom_root / "helpers" / "rights" / "endorsement" / "delegate" ) end module Forge = struct let operations custom_root = RPC.service ~description:"Forge an operation" ~input: Operation.unsigned_operation_encoding ~output: (wrap_tzerror @@ (obj2 (req "operation" @@ describe ~title: "hex encoded operation" bytes) (opt "contracts" @@ describe ~title: "new contracts" (list Contract.encoding)))) RPC.Path.(custom_root / "helpers" / "forge" / "operations" ) let block custom_root = RPC.service ~description: "Forge a block header" ~input: (obj9 (req "net_id" Updater.net_id_encoding) (req "predecessor" Block_hash.encoding) (req "timestamp" Timestamp.encoding) (req "fitness" Fitness.encoding) (req "operations" (list Operation_hash.encoding)) (req "level" Raw_level.encoding) (req "priority" int31) (req "nonce_hash" Nonce_hash.encoding) (req "proof_of_work_nonce" (Fixed.bytes Tezos_context.Constants.proof_of_work_nonce_size))) ~output: (wrap_tzerror bytes) RPC.Path.(custom_root / "helpers" / "forge" / "block") end module Parse = struct let operations custom_root = RPC.service ~description:"Parse an operation" ~input: (obj3 (req "shell" Updater.shell_operation_encoding) (req "proto" (describe ~title: "hex encoded operation" bytes)) (opt "check_signature" bool)) ~output: (wrap_tzerror Operation.proto_operation_encoding) RPC.Path.(custom_root / "helpers" / "parse" / "operations" ) end end