package coop.tx_builder

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc createGcFsTx (CreateGcFsTxReq, CreateGcFsTxResp)

  tx-builder-service.proto:11

  Create a transaction that garbage collects obsolete Fact Statement UTxOs (gc-fact-statement-tx)

  message CreateGcFsTxReq

  tx-builder-service.proto:58

  • repeated bytes fs_ids = 1

    Fact Statement IDs to garbage collect

  • optional cardano.PubKeyHash submitter = 2

    The PubKeyHash of the user that submitted the mint-fact-statement-x and will also submit the gc-fact-statement-tx

  message CreateGcFsTxResp

  tx-builder-service.proto:65

  • oneof transactionOrErr

    • Error error = 1

      Error encountered when servicing the request

    • GcFsSuccess success = 2

      Successfull Fact Statement garbage collection message

  • optional GcFsInfo info = 3

    Request processing information

• rpc createMintFsTx (CreateMintFsTxReq, CreateMintFsTxResp)

  tx-builder-service.proto:9

  Create a transaction that creates Fact Statement UTxOs (mint-fact-statement-tx)

  message CreateMintFsTxReq

  tx-builder-service.proto:14

  • repeated FactStatementInfo fact_statements = 1

  • optional cardano.PubKeyHash submitter = 2

    The PubKeyHash of the user wallet that will sign and submit the transaction (ie. Submitter)

  message CreateMintFsTxResp

  tx-builder-service.proto:20

  • oneof succOrErr

    • Error error = 1

      Error encountered when servicing the request

    • MintFsSuccess success = 2

      Successful Fact Statement Minting message

  • optional MintFsInfo info = 3

    Information about the processing of the request

Error associated with above response messages TODO: Should catch and properly report classes of errors users would expect to trigger. For example: - Collateral finding could fail - $FEE determination could fail - Transaction size due to too many Fact Statements

Used in: publisher.Error, CreateGcFsTxResp, CreateMintFsTxResp

• oneof someError

  • Error.OtherError other_err = 1

    Some other error

Used in: Error

• string msg = 1

  Some other error message

Used in: CreateMintFsTxReq

• bytes fs_id = 1

  Fact Statement ID

• optional cardano.PlutusData fs = 2

  PlutusData encoding of a Fact Statement

• optional cardano.ExtendedLedgerTime gc_after = 3

  Extended ledger time after which the created Fact Statement UTxO can be garbage collected by the Submitter

Info message associated with the CreateGcFsTxResp

Used in: publisher.CreateGcFsTxResponse.Info, CreateGcFsTxResp

• repeated bytes obsolete_fs_ids = 1

  Requested Fact Statement IDs that can be garbage collected with the above transaction

• repeated bytes not_found_fs_ids = 2

  Requested Fact Statement IDs that couldn't be found belonging to the specified Submitter

• repeated bytes valid_fs_ids = 3

  Requested Fact Statement IDs that can't be garbage collected (still valid)

Success message associated with the CreateGcFsTxResp

Used in: CreateGcFsTxResp

• optional cardano.Transaction gc_fs_tx = 1

  Fact Statement garbage collections transaction (abbr. gc-fact-statement-tx) to sign and submit

Information message associated with CreateMintFsTxResp

Used in: publisher.CreateMintFsTxResponse.Info, CreateMintFsTxResp

• repeated MintFsInfo.FsIdAndTxOutRef already_published = 1

  A list of already published Fact Statements (Map FactStatementId TxOutRef)

• repeated bytes published_fs_ids = 2

  Fact Statements ID that will be published with the mint-fact-statement-tx

Used in: MintFsInfo

• bytes fs_id = 1

• optional cardano.TxOutRef fs_utxo = 2

Success message associated with CreateMintFsTxResp

Used in: CreateMintFsTxResp

• optional cardano.Transaction mint_fs_tx = 1

  Fact Statement Minting transaction (abbr. mint-fact-statement-tx) signed by Authenticators