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.