Raiden Glossary¶
- available balance
- The available balance \(B_a\) of a channel participant is \(B_a = B_n - B_l\).
- balance
- The balance \(B_n\) of a channel participant \(P\) is his total deposit \(P_d\) along with the amount of tokens he received \(P_r\) minus the amount \(P_s\) of token he has sent. So \(B_n = P_d + P_r - P_s\)
- balance proof
- Balance proof is any kind of message used in order to cryptographically prove on the blockchain what the latest transferred amount and locked amount received from a counter party is.
- channel capacity
- A channel’s capacity is the sum of the total deposits minus the sum of the total withdraws of both its participants. It is also the sum of the channel participants balance.
- counterparty
- The counterparty of a channel is the other participant of the channel that is not ourselves.
- hashlock
- A hashlock is the hashed secret that accompanies a locked message:
sha3(secret)
. - initiator
- In a payment the initiator is the raiden node which starts the payment
- lock expiration
- The lock expiration is the highest block_number until which the transfer can be settled.
- locked amount
- The locked amount is the total amount of tokens one participant of a payment channel has locked in pending transfers towards his counterparty
- locked balance
- The locked balance \(B_l\) of a channel participant is the sum of the locked amount for all pending transfers \(T_p\). So \(B_l = \sum_{k=0}^{N-1} T_p\) where \(N\) is the number of pending transfers.
- MediatedTransfer
- A mediated transfer is a hashlocked transfer between an initiator and a target propagated through nodes in the network.
- merkletree root
- locksroot
- The root of the
merkle tree
which holds the hashes of all the locks in the channel. - payee
- In a channel relationship between two raiden nodes the payee is the participant who receives a transfer
- payer
- In a channel relationship between two raiden nodes the payer is the participant who sends a transfer.
- payment
- In Raiden a payment denotes the process of sending tokens from one account to another. A payment has an initiator and a target and can be composed of multiple transfers.
- payment channel
- The on-chain payment channel between two raiden nodes.
- preimage
- secret
- The preimage, what we call the secret in Raiden, is 32 bytes of random cryptographically secure data whose keccak hash ends up being the hashlock.
- RefundTransfer
- A refund transfer is a special type of MediatedTransfer that is used when a node can no longer propagate a transfer and a routing backtrack needs to be done.
- reveal timeout
- The number of blocks in a channel allowed for learning about a secret being revealed through the blockchain and acting on it.
- RevealSecret
- The reveal secret message is sent to a node that is known to have an interest to learn the secret.
- secret message
- The secret message is a message containing the secret and used for synchronization between mediated transfer participants.
- SecretRequest
- The secret request message is sent by the target of a mediated transfer to its initiator in order to request the secret to unlock the transfer.
- settlement timeout
- settlement window
- The number of blocks after the closing of a channel within which the counterparty is able to call
updateNonClosingBalanceProof
with the latest balance proof they received. - target
- In a payment the target is the raiden node for which the payment sent by the initiator is intended
- transfer
- In Raiden a transfer denotes a single hop transfer of tokens, either direct or hash time locked inside a payment channel.
- transferred amount
- The transferred amount is the total amount of tokens one participant of a payment channel has sent to his counterparty.