Cross-ledger atomic swap

Hash time lock contract or HTLC is a composition of a hash lock and a time lock. The hash lock authorizes the ClaimHTLC transaction. The time lock authorizes the RefundHTLC transaction. The result of this contract is either success or refund, assuming that transactions are timely executed on the ledger. It is also named an atomic swap.

Hash lock

Hash lock is a cross-ledger authorization mechanism that requires a preimage of a cryptographic hash.

Implemented types:

• BLAKE2b-256
• SHA-256
• Keccak-256
• RIPEMD-160

Time lock

Time lock is a cross-ledger authorization mechanism that requires a specified ledger time or height to pass.

Implemented types:

• Absolute ledger time
• Absolute ledger height
• Relative ledger time
• Relative ledger height

RPC API

In version 0.3 RPC API will be implemented.

• Create atomic swap
  Type	POST
  Path	/createswap
  Parameters
  mnemonic	mnemonic of wallet
  fee	transaction fee
  amount	amount to transfer
  to	address of receiving account
  timelocktype	0 for absolute time, 1 for absolute height, 2 for relative time, 3 for relative height
  timelockdata	time or height depending on type
  hashlocktype	0 for BLAKE2b-256, 1 for SHA-256, 2 for Keccak-256, 3 for RIPEMD-160
  hashlockdata	HEX-encoded hash

  Returns transaction hash.

• Claim atomic swap
  Type	POST
  Path	/claimswap
  Parameters
  mnemonic	mnemonic of wallet
  fee	transaction fee
  id	address of atomic swap
  preimage	HEX-encoded preimage

  Returns transaction hash.

• Refund atomic swap
  Type	POST
  Path	/refundswap
  Parameters
  mnemonic	mnemonic of wallet
  fee	transaction fee
  id	address of atomic swap

  Returns transaction hash.