Skip to main content
Version: main branch

Permissioned User Token Partition Transaction Types

In a Permissioned User Token Partition, where only pre-authorized parties can send transaction orders, the partition will accept all the transactions as defined in the User Token Partition Transaction Types, except for the addFC and closeFC transactions. Instead, the partition accepts the setFC and delFC transactions defined below.

The purpose of the setFC transaction is to permit a client to send transaction orders to the partition and the purpose of the delFC transaction is to revoke the permission.

The UnitID and UnitID types values are the same as defined in the User Token Partition Transaction Types except for the PartitionID, there are no reserved values for permissioned partitions.

Set Fee Credit

This transaction creates or updates a fee credit record.

TransactionOrder.Type = 20
TransactionOrder.Attributes contains:

/SetFeeCreditAttributes/ [
/OwnerPredicate/ h'53',
/Amount/ 10000000000,
/Counter/ null,
]
  1. OwnerPredicate (byte string) is the owner predicate to be set to the fee credit record. The fee proofs of user transactions must satisfy this predicate.
  2. Amount (unsigned integer) the fee credit amount (in tema) to be added to the fee credit record. When updating an existing fee credit record the value is incremented by this amount.
  3. Counter (unsigned integer) is the current counter value of the fee credit record, or null when creating a new fee credit record.

TransactionOrder.AuthProof contains:

/AuthProof/ [
/OwnerProof/ [h'53'],
],
  1. OwnerProof (byte string) is the input to satisfy the admin owner predicate defined in the permissioned tokens genesis file, that is, the SetFC transaction must be signed by the owner of the partition.

Delete Fee Credit

This transaction deletes a fee credit record.

TransactionOrder.Type = 21
TransactionOrder.Attributes contains:

/DeleteFeeCreditAttributes/ [
/Counter/ 123,
]
  1. Counter (unsigned integer) is the current counter value of the fee credit record.

TransactionOrder.AuthProof contains:

/AuthProof/ [
/OwnerProof/ [h'53'],
],
  1. OwnerProof (byte string) is the input to satisfy the admin owner predicate defined in the permissioned tokens genesis file, that is, the DelFC transaction must be signed by the owner of the partition.