package bitswap.pb.v130

Get desktop application:
View/edit binary Protocol Buffers messages

• optional Message.Wantlist wantlist = 1

  ─── TOP-LEVEL MESSAGE FIELDS ────────────────────────────────────────── Fields 1-5: identical to Bitswap 1.2.0 (never modified)

• repeated bytes blocks = 2

  deprecated since 1.1.0

• repeated Message.Block payload = 3

• repeated Message.BlockPresence blockPresences = 4

  type=2 means PAYMENT_REQUIRED

• int32 pendingBytes = 5

• repeated Message.PaymentTerms payment_terms = 6

  Fields 6-9: NEW in 1.3.0 (safe unknown fields for old parsers)

  server → client

• repeated Message.PaymentAuthorization payment_authorizations = 7

  client → server

• repeated Message.PaymentReceipt payment_receipts = 8

  server → client

• repeated Message.PaymentRejection payment_rejections = 9

  server → client

─── EXISTING: Block payload (unchanged from 1.1.0) ─────────────────────

Used in: Message

• bytes prefix = 1

  CID prefix: version + codec varint

• bytes data = 2

  raw block bytes

─── EXISTING: BlockPresence (unchanged structure, extended enum) ────────

Used in: Message

• bytes cid = 1

• BlockPresenceType type = 2

  Now can be 0, 1, or 2

─── EXTENDED: BlockPresenceType — NEW value PaymentRequired = 2 ────────

Used in: BlockPresence

• Have = 0

  server has the block

• DontHave = 1

  server genuinely does not have the block

• PaymentRequired = 2

  [NEW 1.3.0] server has the block but requires payment

─── NEW 1.3.0: PaymentAuthorization — client's signed proof of payment

Used in: Message

• bytes cid = 1

  CID being paid for

• string from_address = 2

  Client's wallet address

• string to_address = 3

  Must match PaymentTerms.pay_to

• uint64 value = 4

  Must be >= PaymentTerms.amount

• uint64 valid_after = 5

  EIP-3009 validAfter (typically 0)

• uint64 valid_before = 6

  EIP-3009 validBefore

• bytes nonce = 7

  Must match PaymentTerms.nonce exactly

• uint32 v = 8

  ECDSA signature recovery id (27 or 28)

• bytes r = 9

  ECDSA r component (32 bytes)

• bytes s = 10

  ECDSA s component (32 bytes)

• string scheme = 11

  Must match PaymentTerms.scheme

─── NEW 1.3.0: PaymentReceipt — server confirms payment accepted

Used in: Message

• bytes cid = 1

  CID now authorized to be served

• string tx_hash = 2

  On-chain tx hash (empty in OPTIMISTIC mode)

• uint64 expires = 3

  Unix ts: this authorization is valid until this time

─── NEW 1.3.0: PaymentRejection — server rejects a PaymentAuthorization

Used in: Message

• bytes cid = 1

• string reason = 2

  "INVALID_SIGNATURE" | "WRONG_AMOUNT" | "NONCE_USED" | "EXPIRED"

─── NEW 1.3.0: PaymentTerms — embedded in Message when type=PaymentRequired

Used in: Message

• bytes cid = 1

  CID of the gated block

• string asset = 2

  Token contract address

• string pay_to = 3

  Server's wallet address

• uint64 amount = 4

  Amount in token's smallest unit

• string network = 5

  Chain identifier: "base-sepolia" | "base-mainnet"

• bytes nonce = 6

  Random 32 bytes — per-offer, prevents replay attacks

• uint64 valid_before = 7

  Unix timestamp: offer expires after this

• uint64 block_size = 8

  Actual block size in bytes

• string description = 9

  Human-readable description

• string scheme = 10

  Payment scheme: "exact" (EIP-3009)

─── EXISTING: Wantlist (unchanged from 1.2.0) ─────────────────────────

Used in: Message

• repeated Wantlist.Entry entries = 1

• bool full = 2

  true = authoritative wantlist replacement

Used in: Wantlist

• bytes block = 1

  CID bytes (CIDv1 binary)

• int32 priority = 2

  higher = serve first; default 1

• bool cancel = 3

  true = remove from wantlist

• WantType wantType = 4

  Block or Have

• bool sendDontHave = 5

  server MUST respond DONT_HAVE if missing

Used in: Entry

• Block = 0

  default: client wants the full block

• Have = 1

  client only wants to know if server has it