Welcome to the interBTC Technical Specification!

Note

Please note that this specification is a living document. The actual implementation might deviate from the specification. In case of deviations in the code, the code has priority over the specification.

Introduction

• interBTC at a Glance
  • Functionality
  • Components
• Cryptocurrency-backed Assets
  • Cryptocurrency-back Assets (CbA)
  • Design Principles
  • Recommended Background Reading
• Architecture
  • Actors
  • Modules
  • Interactions
• Polkadot
  • Substrate
  • Substrate Specifics
• Bitcoin Data Model
  • Block Headers
  • Transactions
  • Inputs
  • Outputs
  • Witness
  • Witness Stack Item
• Accepted Bitcoin Transaction Format
  • Case 1: OP_RETURN Transactions
  • Case 2: Regular P2PKH / P2WPKH / P2SH / P2WSH Transactions
• How to Read This Specification
  • External Functions
  • Internal Functions
  • Preconditions, Postconditions and Invariants
  • Errors and Events

Specification

• BTC-Relay
  • Overview
  • Specification
• Collateral
  • Overview
• Currency
  • Overview
  • Data Model
  • Functions
• Fee
  • Overview
  • Data Model
  • Functions
  • Events
• Oracle
  • Data Model
  • Functions
  • Events
• Issue
  • Overview
  • Data Model
  • Functions
  • Events
  • Error Codes
• Refund
  • Overview
  • Data Model
  • External Functions
  • Internal Functions
  • Events
• Redeem
  • Overview
  • Data Model
  • Functions
  • Events
  • Error Codes
• Replace
  • Overview
  • Data Model
  • Functions
  • Events
  • Error Codes
• Security
  • Overview
  • Data Model
  • Data Storage
  • Functions
  • Events
• Relay
  • Overview
  • Data Storage
  • Functions
  • Events
• Treasury
  • Overview
• Vault Registry
  • Overview
  • Data Model
  • External Functions
  • Internal Functions
  • Events
  • Error Codes
• Vault Nomination
  • Overview
  • Protocol
  • Data Model
  • Functions
  • Events
• Reward
  • Overview
  • Invariants
  • Data Model
  • Functions
  • Events
• Staking
  • Overview
  • Data Model
  • Functions
• Escrow
  • Overview
  • Data Model
  • External Functions
  • Internal Functions
  • Events
• Governance
  • Overview
  • Terminology
  • Processes
  • Parameters

Security and Performance

• Vault Liquidations
  • Safety Failures
  • Crash Failures
  • Liquidations (Safety Failures)
• XCLAIM Security Analysis
  • Replay Attacks
  • Counterfeiting
  • Permanent Blockchain Splits
  • Denial-of-Service Attacks
  • Fee Model Security: Sybil Attacks and Extortion
  • Griefing
  • Concurrency
• BTC-Relay Security Analysis
  • Security Parameter k
  • Liveness Failures
  • Safety Failures
  • Hard and Soft forks
• Performance Analysis
  • Estimation of Storage Costs
  • BTC-Relay Optimizations

Economics

• Economic Incentives
  • Currencies
  • Actors: Roles, Risks, and Economics
  • Challenges Around Economic Efficiency
  • External Economic Risks
• Fee Model
  • Payment Flows
  • interBTC Fee Model
  • Transaction Fee Model

All the rest

• License
• Interlay