Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface PaymentChannelCreate

Create a unidirectional channel and fund it with XRP. The address sending this transaction becomes the "source address" of the payment channel.

Hierarchy

  • BaseTransaction
    • PaymentChannelCreate

Index

Properties

Account

Account: string

The unique address of the account that initiated the transaction.

Optional AccountTxnID

AccountTxnID?: string

Hash value identifying another transaction. If provided, this transaction is only valid if the sending account's previously-sent transaction matches the provided hash.

Amount

Amount: string

Amount of XRP, in drops, to deduct from the sender's balance and set aside in this channel. While the channel is open, the XRP can only go to the Destination address. When the channel closes, any unclaimed XRP is returned to the source address's balance.

Optional CancelAfter

CancelAfter?: number

The time, in seconds since the Ripple Epoch, when this channel expires. Any transaction that would modify the channel after this time closes the channel without otherwise affecting it. This value is immutable; the channel can be closed earlier than this time but cannot remain open after this time.

Destination

Destination: string

Address to receive XRP claims against this channel. This is also known as the "destination address" for the channel.

Optional DestinationTag

DestinationTag?: number

Arbitrary tag to further specify the destination for this payment channel, such as a hosted recipient at the destination address.

Optional Fee

Fee?: string

Integer amount of XRP, in drops, to be destroyed as a cost for distributing this transaction to the network. Some transaction types have different minimum requirements.

Optional Flags

Flags?: number | GlobalFlags

Set of bit-flags for this transaction.

Optional LastLedgerSequence

LastLedgerSequence?: number

Highest ledger index this transaction can appear in. Specifying this field places a strict upper limit on how long the transaction can wait to be validated or rejected.

Optional Memos

Memos?: Memo[]

Additional arbitrary information used to identify this transaction.

PublicKey

PublicKey: string

The public key of the key pair the source will use to sign claims against this channel in hexadecimal. This can be any secp256k1 or ed25519 public key.

Optional Sequence

Sequence?: number

The sequence number of the account sending the transaction. A transaction is only valid if the Sequence number is exactly 1 greater than the previous transaction from the same account. The special case 0 means the transaction is using a Ticket instead.

SettleDelay

SettleDelay: number

Amount of time the source address must wait before closing the channel if it has unclaimed XRP.

Optional Signers

Signers?: Signer[]

Array of objects that represent a multi-signature which authorizes this transaction.

Optional SigningPubKey

SigningPubKey?: string

Hex representation of the public key that corresponds to the private key used to sign this transaction. If an empty string, indicates a multi-signature is present in the Signers field instead.

Optional SourceTag

SourceTag?: number

Arbitrary integer used to identify the reason for this payment, or a sender on whose behalf this transaction is made. Conventionally, a refund should specify the initial payment's SourceTag as the refund payment's DestinationTag.

Optional TicketSequence

TicketSequence?: number

The sequence number of the ticket to use in place of a Sequence number. If this is provided, Sequence must be 0. Cannot be used with AccountTxnID.

TransactionType

TransactionType: "PaymentChannelCreate"

Optional TxnSignature

TxnSignature?: string

The signature that verifies this transaction as originating from the account it says it is from.

Generated using TypeDoc