antd 0.2.0 → 0.3.0

data/lib/antd/models.rb

@@ -195,4 +195,225 @@ module Antd
     end
     alias_method :is_meta, :meta?
   end
+
+  # One +payments+ quote in full signed form, returned by +pointer_prepare+
+  # when called with +include_signed_quotes: true+. +quote+ and
+  # +commitment_sidecar+ are opaque base64 strings on both transports (the
+  # gRPC client encodes the proto's bytes the same way); only antd parses
+  # them. +commitment_sidecar+ is nil for baseline quotes.
+  SignedQuoteEntry = Struct.new(:quote_hash, :quote, :commitment_sidecar, keyword_init: true)
+
+  # --- Pointers (ADR-0016 / ADR-0018 in ant-node) ---
+  #
+  # A pointer is a small, owner-signed, mutable reference. Its address is
+  # derived from the owner's key and never changes; what it points at (a
+  # chunk, such as a public file's data map, or another pointer) can be
+  # changed by the owner, and the owner can hand it over to another pointer
+  # for good. antd signs with owner keys it loaded at startup
+  # (+--pointer-keys+), so a write names the pointer by its address (+owner+),
+  # never by a key.
+  #
+  # Every write pays, and every attempt pays again: never retry a create,
+  # update, transfer or finalize automatically.
+
+  # Counter of a pointer's final state, after a transfer or a freeze:
+  # 2^64 - 1 (u64::MAX). Nothing can replace a state at this counter.
+  POINTER_FINAL_COUNTER = 18_446_744_073_709_551_615
+
+  # What a pointer's target is. Pass as +kind:+ to the pointer writes; the
+  # daemon defaults to +CHUNK+ when it is omitted.
+  module PointerKind
+    # An immutable chunk, such as a public file's data map. The default.
+    CHUNK = "chunk"
+    # Another pointer: a forwarding the owner can still change. Use
+    # +pointer_transfer+ to hand a pointer over for good.
+    POINTER = "pointer"
+
+    # The kind a raw +kind_tag+ names (0 chunk, 1 pointer), or nil for a tag
+    # this SDK does not know.
+    #
+    # @param tag [Integer]
+    # @return [String, nil]
+    def self.from_tag(tag)
+      case tag
+      when 0 then CHUNK
+      when 1 then POINTER
+      end
+    end
+  end
+
+  # The write +pointer_prepare+ signs for an external signer.
+  module PointerOp
+    # Create the pointer at +target+. Refused if it already exists.
+    CREATE = "create"
+    # Point the pointer at +target+, creating it if it does not exist.
+    UPDATE = "update"
+    # Hand the pointer over for good to the pointer at +recipient+, which must
+    # already exist. Irreversible once stored.
+    TRANSFER = "transfer"
+  end
+
+  # Where a pointer stands with respect to finality (+PointerFinality#status+).
+  #
+  # The status is the daemon's wire string. These are the values this SDK
+  # knows; a newer daemon may send another, which is kept verbatim (the
+  # "unknown" arm: +PointerFinality#status_known?+ is false). Give a +case+
+  # over the status an +else+ branch.
+  module PointerFinalityStatus
+    # No peer that answered holds a final state: the owner can still move the
+    # pointer. Rules a final state out only when every peer answered.
+    OPEN = "open"
+    # One final state, not yet held by a majority: a transfer still
+    # spreading, or a write that fell short.
+    SETTLING = "settling"
+    # One final state held by a majority, but not every peer answered, so a
+    # rival could still be unseen. Ask again.
+    UNCONFIRMED = "unconfirmed"
+    # One final state held by a majority, every peer answered, no rival. The
+    # only status a recipient should rely on.
+    FINAL = "final"
+    # The owner signed two or more different final states.
+    FORKED = "forked"
+
+    # Every status this SDK knows.
+    KNOWN = [OPEN, SETTLING, UNCONFIRMED, FINAL, FORKED].freeze
+
+    # @param status [String]
+    # @return [Boolean] whether this SDK knows +status+
+    def self.known?(status)
+      KNOWN.include?(status)
+    end
+  end
+
+  # The state a pointer write stored (+pointer_create+ / +pointer_update+).
+  # +counter+ is an Integer; a final state sits at +POINTER_FINAL_COUNTER+.
+  PointerWriteResult = Struct.new(:address, :state_id, :counter, keyword_init: true)
+
+  # A pointer's current state, as the network serves it (+pointer_get+).
+  #
+  # - +owner+: the owner's ML-DSA-65 public key (hex, 1,952 bytes). The
+  #   address is derived from it, so it is the proof of who owns the pointer.
+  # - +counter+: Integer, +POINTER_FINAL_COUNTER+ once final.
+  # - +kind+: "chunk", "pointer", or "unknown" for a kind the daemon does not
+  #   know; +kind_tag+ carries the raw value either way.
+  # - +is_final+: the state is at the final counter, so nothing can replace it.
+  # - +transferred_to+: the pointer this one was handed over to, or nil.
+  PointerRecord = Struct.new(
+    :address, :owner, :counter, :kind, :kind_tag, :target, :state_id,
+    :is_final, :transferred_to,
+    keyword_init: true
+  ) do
+    # @return [Boolean] true at the final counter: transferred or frozen
+    def final?
+      is_final == true
+    end
+
+    # @return [String, nil] the target's +PointerKind+, if this SDK knows its tag
+    def target_kind
+      PointerKind.from_tag(kind_tag)
+    end
+  end
+
+  # Where a chain of pointers ends (+pointer_resolve+): the target's +kind+
+  # ("chunk", or "unknown" for a kind the daemon does not know), its raw
+  # +kind_tag+ and the +target+ address.
+  PointerTarget = Struct.new(:kind, :kind_tag, :target, keyword_init: true) do
+    # @return [String, nil] the target's +PointerKind+, if this SDK knows its tag
+    def target_kind
+      PointerKind.from_tag(kind_tag)
+    end
+  end
+
+  # One final state, as a finality check reports it. +holders+ is how many
+  # peers of the close group hold it; +transferred_to+ is nil unless the
+  # state is a transfer.
+  PointerFinalState = Struct.new(
+    :state_id, :kind, :kind_tag, :target, :holders, :transferred_to,
+    keyword_init: true
+  )
+
+  # Where a pointer stands, as its whole close group reports it
+  # (+pointer_finality+). Check it before relying on a transfer: only
+  # +final?+ means the transfer is beyond dispute.
+  #
+  # - +group+ / +answered+: peers in the close group, and peers that answered.
+  # - +status+: a +PointerFinalityStatus+ string (see there for unknown ones).
+  # - +counter+: +open+ only, the Integer counter a read would return, or nil
+  #   when no state is corroborated.
+  # - +state+: +settling+, +unconfirmed+ and +final+, the one final state seen
+  #   (+PointerFinalState+), else nil.
+  # - +states+ / +majority+: +forked+ only, every final state seen (most-held
+  #   first) and the one a majority holds, which reads return. +states+ is
+  #   empty and +majority+ nil otherwise.
+  # - +transferred_to+: the pointer this one was handed over to, once that is
+  #   beyond dispute (status +final+), else nil.
+  PointerFinality = Struct.new(
+    :address, :group, :answered, :status, :counter, :state, :states,
+    :majority, :transferred_to,
+    keyword_init: true
+  ) do
+    # @return [Boolean] one final state, held by a majority, every peer
+    #   answering and no rival seen
+    def final?
+      status == PointerFinalityStatus::FINAL
+    end
+
+    # @return [Boolean] false for a status a newer daemon added
+    def status_known?
+      PointerFinalityStatus.known?(status)
+    end
+  end
+
+  # Whose pointer decides what an address resolves to, after following every
+  # transfer (+pointer_controller+). +transfers+ lists every pointer the
+  # address was handed over to, in order; +frozen+ is true when +pointer+ is
+  # final without being handed over, so nobody can move it.
+  PointerController = Struct.new(:pointer, :transfers, :frozen, keyword_init: true)
+
+  # What a transfer stored, and where the close group says it stands.
+  # +finality+ (a +PointerFinality+) is nil when that check failed, and
+  # +finality_error+ says why; the transfer itself is stored and final either
+  # way. Ask again with +pointer_finality+.
+  PointerTransferResult = Struct.new(:address, :state_id, :finality, :finality_error, keyword_init: true)
+
+  # A pointer write signed by the daemon and quoted for an external signer
+  # (+pointer_prepare+). Pay +payments+ with +payForQuotes()+, then call
+  # +pointer_finalize+. +op+ is a +PointerOp+ string, +counter+ an Integer,
+  # +payment_type+ always "wave_batch" (a pointer state is paid with one
+  # quote). +signed_quotes+ (+SignedQuoteEntry+) is filled only when the
+  # prepare asked for it, else empty.
+  #
+  # While it awaits payment, other writes to the pointer raise
+  # +ConflictError+ until it is finalized or expires (one hour).
+  PointerPrepareResult = Struct.new(
+    :upload_id, :op, :address, :state_id, :counter, :payment_type,
+    :payments, :total_amount, :payment_vault_address, :payment_token_address,
+    :rpc_url, :signed_quotes,
+    keyword_init: true
+  )
+
+  # The state a pointer finalize stored. +finality+ is set for a transfer
+  # (where the close group says it stands), else nil.
+  PointerFinalizeResult = Struct.new(:address, :state_id, :counter, :finality, keyword_init: true)
+
+  # Parses a pointer counter. The daemon sends counters as decimal strings on
+  # both transports, because a final state sits at 2^64 - 1, past what a JSON
+  # number keeps exactly in many languages. Ruby integers are unbounded, so
+  # the value is checked against the daemon's u64 range here.
+  #
+  # Strict: only a String of ASCII digits within u64 parses. +Integer()+ alone
+  # would also take a sign, underscores or a radix prefix, and a malformed
+  # counter must never read as 0.
+  #
+  # @param field [String] the field name, for the error message
+  # @param value [Object] the wire value
+  # @return [Integer]
+  # @raise [InternalError] when +value+ is not a decimal u64
+  def self.parse_pointer_counter(field, value)
+    if value.is_a?(String) && value.match?(/\A[0-9]+\z/)
+      n = Integer(value, 10)
+      return n if n <= POINTER_FINAL_COUNTER
+    end
+    raise InternalError, "invalid pointer #{field} #{value.inspect}: expected a decimal u64"
+  end
 end

data/lib/antd/v1/data_pb.rb

@@ -7,7 +7,7 @@ require 'google/protobuf'
 require 'antd/v1/common_pb'
 
 
-descriptor_data = "\n\x12\x61ntd/v1/data.proto\x12\x07\x61ntd.v1\x1a\x14\x61ntd/v1/common.proto\"\'\n\x14GetPublicDataRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"%\n\x15GetPublicDataResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\":\n\x14PutPublicDataRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t\"w\n\x15PutPublicDataResponse\x12\x1b\n\x04\x63ost\x18\x01 \x01(\x0b\x32\r.antd.v1.Cost\x12\x0f\n\x07\x61\x64\x64ress\x18\x02 \x01(\t\x12\x15\n\rchunks_stored\x18\x03 \x01(\x04\x12\x19\n\x11payment_mode_used\x18\x04 \x01(\t\"D\n\x17StreamPublicDataRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x18\n\x10include_progress\x18\x02 \x01(\x08\"R\n\tDataChunk\x12\x0e\n\x04\x64\x61ta\x18\x01 \x01(\x0cH\x00\x12-\n\x08progress\x18\x02 \x01(\x0b\x32\x19.antd.v1.DownloadProgressH\x00\x42\x06\n\x04kind\"A\n\x10\x44ownloadProgress\x12\r\n\x05phase\x18\x01 \x01(\t\x12\x0f\n\x07\x66\x65tched\x18\x02 \x01(\x04\x12\r\n\x05total\x18\x03 \x01(\x04\"\"\n\x0eGetDataRequest\x12\x10\n\x08\x64\x61ta_map\x18\x01 \x01(\t\"?\n\x11StreamDataRequest\x12\x10\n\x08\x64\x61ta_map\x18\x01 \x01(\t\x12\x18\n\x10include_progress\x18\x02 \x01(\x08\"\x1f\n\x0fGetDataResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"4\n\x0ePutDataRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t\"r\n\x0fPutDataResponse\x12\x1b\n\x04\x63ost\x18\x01 \x01(\x0b\x32\r.antd.v1.Cost\x12\x10\n\x08\x64\x61ta_map\x18\x02 \x01(\t\x12\x15\n\rchunks_stored\x18\x03 \x01(\x04\x12\x19\n\x11payment_mode_used\x18\x04 \x01(\t\"5\n\x0f\x44\x61taCostRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t2\xce\x03\n\x0b\x44\x61taService\x12\x38\n\x03Put\x12\x17.antd.v1.PutDataRequest\x1a\x18.antd.v1.PutDataResponse\x12J\n\tPutPublic\x12\x1d.antd.v1.PutPublicDataRequest\x1a\x1e.antd.v1.PutPublicDataResponse\x12\x38\n\x03Get\x12\x17.antd.v1.GetDataRequest\x1a\x18.antd.v1.GetDataResponse\x12J\n\tGetPublic\x12\x1d.antd.v1.GetPublicDataRequest\x1a\x1e.antd.v1.GetPublicDataResponse\x12:\n\x06Stream\x12\x1a.antd.v1.StreamDataRequest\x1a\x12.antd.v1.DataChunk0\x01\x12\x46\n\x0cStreamPublic\x12 .antd.v1.StreamPublicDataRequest\x1a\x12.antd.v1.DataChunk0\x01\x12/\n\x04\x43ost\x12\x18.antd.v1.DataCostRequest\x1a\r.antd.v1.CostBDZ8github.com/WithAutonomi/ant-sdk/antd-go/proto/antd/v1;v1\xaa\x02\x07\x41ntd.V1b\x06proto3"
+descriptor_data = "\n\x12\x61ntd/v1/data.proto\x12\x07\x61ntd.v1\x1a\x14\x61ntd/v1/common.proto\"\'\n\x14GetPublicDataRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"%\n\x15GetPublicDataResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\":\n\x14PutPublicDataRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t\"w\n\x15PutPublicDataResponse\x12\x1b\n\x04\x63ost\x18\x01 \x01(\x0b\x32\r.antd.v1.Cost\x12\x0f\n\x07\x61\x64\x64ress\x18\x02 \x01(\t\x12\x15\n\rchunks_stored\x18\x03 \x01(\x04\x12\x19\n\x11payment_mode_used\x18\x04 \x01(\t\"\x84\x01\n\x17StreamPublicDataRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x18\n\x10include_progress\x18\x02 \x01(\x08\x12\x13\n\x06offset\x18\x03 \x01(\x04H\x00\x88\x01\x01\x12\x13\n\x06length\x18\x04 \x01(\x04H\x01\x88\x01\x01\x42\t\n\x07_offsetB\t\n\x07_length\"R\n\tDataChunk\x12\x0e\n\x04\x64\x61ta\x18\x01 \x01(\x0cH\x00\x12-\n\x08progress\x18\x02 \x01(\x0b\x32\x19.antd.v1.DownloadProgressH\x00\x42\x06\n\x04kind\"A\n\x10\x44ownloadProgress\x12\r\n\x05phase\x18\x01 \x01(\t\x12\x0f\n\x07\x66\x65tched\x18\x02 \x01(\x04\x12\r\n\x05total\x18\x03 \x01(\x04\"\"\n\x0eGetDataRequest\x12\x10\n\x08\x64\x61ta_map\x18\x01 \x01(\t\"\x7f\n\x11StreamDataRequest\x12\x10\n\x08\x64\x61ta_map\x18\x01 \x01(\t\x12\x18\n\x10include_progress\x18\x02 \x01(\x08\x12\x13\n\x06offset\x18\x03 \x01(\x04H\x00\x88\x01\x01\x12\x13\n\x06length\x18\x04 \x01(\x04H\x01\x88\x01\x01\x42\t\n\x07_offsetB\t\n\x07_length\"\x1f\n\x0fGetDataResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"4\n\x0ePutDataRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t\"r\n\x0fPutDataResponse\x12\x1b\n\x04\x63ost\x18\x01 \x01(\x0b\x32\r.antd.v1.Cost\x12\x10\n\x08\x64\x61ta_map\x18\x02 \x01(\t\x12\x15\n\rchunks_stored\x18\x03 \x01(\x04\x12\x19\n\x11payment_mode_used\x18\x04 \x01(\t\"5\n\x0f\x44\x61taCostRequest\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x14\n\x0cpayment_mode\x18\x02 \x01(\t2\xce\x03\n\x0b\x44\x61taService\x12\x38\n\x03Put\x12\x17.antd.v1.PutDataRequest\x1a\x18.antd.v1.PutDataResponse\x12J\n\tPutPublic\x12\x1d.antd.v1.PutPublicDataRequest\x1a\x1e.antd.v1.PutPublicDataResponse\x12\x38\n\x03Get\x12\x17.antd.v1.GetDataRequest\x1a\x18.antd.v1.GetDataResponse\x12J\n\tGetPublic\x12\x1d.antd.v1.GetPublicDataRequest\x1a\x1e.antd.v1.GetPublicDataResponse\x12:\n\x06Stream\x12\x1a.antd.v1.StreamDataRequest\x1a\x12.antd.v1.DataChunk0\x01\x12\x46\n\x0cStreamPublic\x12 .antd.v1.StreamPublicDataRequest\x1a\x12.antd.v1.DataChunk0\x01\x12/\n\x04\x43ost\x12\x18.antd.v1.DataCostRequest\x1a\r.antd.v1.CostBDZ8github.com/WithAutonomi/ant-sdk/antd-go/proto/antd/v1;v1\xaa\x02\x07\x41ntd.V1b\x06proto3"
 
 pool = ::Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)

data/lib/antd/v1/manifests_pb.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: antd/v1/manifests.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x17\x61ntd/v1/manifests.proto\x12\x07\x61ntd.v1\"}\n\x12ManifestEntryInput\x12\x11\n\x04path\x18\x01 \x01(\tH\x01\x88\x01\x01\x12\x11\n\x04size\x18\x02 \x01(\x04H\x02\x88\x01\x01\x12\x12\n\x08\x64\x61ta_map\x18\x03 \x01(\tH\x00\x12\x11\n\x07\x61\x64\x64ress\x18\x04 \x01(\tH\x00\x42\x08\n\x06sourceB\x07\n\x05_pathB\x07\n\x05_size\"\xa7\x01\n\x14\x42uildManifestRequest\x12\x11\n\x04name\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x1b\n\x13torrent_info_hashes\x18\x02 \x03(\t\x12\x18\n\x0b\x65mbed_roots\x18\x03 \x01(\x08H\x01\x88\x01\x01\x12,\n\x07\x65ntries\x18\x04 \x03(\x0b\x32\x1b.antd.v1.ManifestEntryInputB\x07\n\x05_nameB\x0e\n\x0c_embed_roots\"\xd3\x01\n\x11ManifestEntryInfo\x12\x16\n\x0e\x65\x66\x66\x65\x63tive_name\x18\x01 \x01(\t\x12\x11\n\x04path\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x11\n\x04size\x18\x03 \x01(\x04H\x01\x88\x01\x01\x12\x0c\n\x04kind\x18\x04 \x01(\t\x12\x17\n\x0f\x63ontent_address\x18\x05 \x01(\t\x12\x10\n\x08\x64\x61ta_map\x18\x06 \x01(\t\x12\x17\n\nexact_size\x18\x07 \x01(\x04H\x02\x88\x01\x01\x12\r\n\x05\x65rror\x18\x08 \x01(\tB\x07\n\x05_pathB\x07\n\x05_sizeB\r\n\x0b_exact_size\"d\n\x15\x42uildManifestResponse\x12\x10\n\x08manifest\x18\x01 \x01(\x0c\x12\x0c\n\x04link\x18\x02 \x01(\t\x12+\n\x07\x65ntries\x18\x03 \x03(\x0b\x32\x1a.antd.v1.ManifestEntryInfo\"U\n\x15\x44\x65\x63odeManifestRequest\x12\x12\n\x08manifest\x18\x01 \x01(\x0cH\x00\x12\x0e\n\x04link\x18\x02 \x01(\tH\x00\x12\x0f\n\x07resolve\x18\x03 \x01(\x08\x42\x07\n\x05input\"\xad\x01\n\x16\x44\x65\x63odeManifestResponse\x12\x0e\n\x06source\x18\x01 \x01(\t\x12\x11\n\x04name\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x1c\n\x14torrent_info_hash_v1\x18\x03 \x01(\t\x12\x1c\n\x14torrent_info_hash_v2\x18\x04 \x01(\t\x12+\n\x07\x65ntries\x18\x05 \x03(\x0b\x32\x1a.antd.v1.ManifestEntryInfoB\x07\n\x05_name2\xa4\x01\n\x0fManifestService\x12\x46\n\x05\x42uild\x12\x1d.antd.v1.BuildManifestRequest\x1a\x1e.antd.v1.BuildManifestResponse\x12I\n\x06\x44\x65\x63ode\x12\x1e.antd.v1.DecodeManifestRequest\x1a\x1f.antd.v1.DecodeManifestResponseBDZ8github.com/WithAutonomi/ant-sdk/antd-go/proto/antd/v1;v1\xaa\x02\x07\x41ntd.V1b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Antd
+  module V1
+    ManifestEntryInput = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.ManifestEntryInput").msgclass
+    BuildManifestRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.BuildManifestRequest").msgclass
+    ManifestEntryInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.ManifestEntryInfo").msgclass
+    BuildManifestResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.BuildManifestResponse").msgclass
+    DecodeManifestRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.DecodeManifestRequest").msgclass
+    DecodeManifestResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.DecodeManifestResponse").msgclass
+  end
+end

data/lib/antd/v1/manifests_services_pb.rb

@@ -0,0 +1,39 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: antd/v1/manifests.proto for package 'antd.v1'
+
+require 'grpc'
+require 'antd/v1/manifests_pb'
+
+module Antd
+  module V1
+    module ManifestService
+      # ADR-0006 file manifests: `.ant` files and `ant://` links (V2-1570).
+      #
+      # Stateless. The format, content addresses, link encoding and portable path
+      # rules all come from ant-core, so callers never re-implement them. The
+      # network is touched only to resolve DataMaps: the embedding policy on
+      # Build, and `resolve` on Decode.
+      #
+      # Both calls are unary. A manifest is one document of at most 64 MiB that is
+      # produced and parsed whole, so the server accepts requests up to 100 MiB
+      # (the REST body limit); clients receiving a large manifest must raise their
+      # receive limit (antd-go does this per call).
+      class Service
+
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'antd.v1.ManifestService'
+
+        # Build a manifest from DataMaps and public addresses already in hand.
+        # Nothing is uploaded or paid for.
+        rpc :Build, ::Antd::V1::BuildManifestRequest, ::Antd::V1::BuildManifestResponse
+        # Decode `.ant` bytes, a manifest link, a file link or a bare address.
+        rpc :Decode, ::Antd::V1::DecodeManifestRequest, ::Antd::V1::DecodeManifestResponse
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/antd/v1/pointers_pb.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: antd/v1/pointers.proto
+
+require 'google/protobuf'
+
+require 'antd/v1/common_pb'
+
+
+descriptor_data = "\n\x16\x61ntd/v1/pointers.proto\x12\x07\x61ntd.v1\x1a\x14\x61ntd/v1/common.proto\"\x18\n\x16ListPointerKeysRequest\"<\n\x17ListPointerKeysResponse\x12!\n\x04keys\x18\x01 \x03(\x0b\x32\x13.antd.v1.PointerKey\"\x1d\n\nPointerKey\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"B\n\x13PointerWriteRequest\x12\r\n\x05owner\x18\x01 \x01(\t\x12\x0e\n\x06target\x18\x02 \x01(\t\x12\x0c\n\x04kind\x18\x03 \x01(\t\"J\n\x14PointerWriteResponse\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x10\n\x08state_id\x18\x02 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x03 \x01(\t\":\n\x16PointerTransferRequest\x12\r\n\x05owner\x18\x01 \x01(\t\x12\x11\n\trecipient\x18\x02 \x01(\t\"\x80\x01\n\x17PointerTransferResponse\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x10\n\x08state_id\x18\x02 \x01(\t\x12*\n\x08\x66inality\x18\x03 \x01(\x0b\x32\x18.antd.v1.PointerFinality\x12\x16\n\x0e\x66inality_error\x18\x04 \x01(\t\"$\n\x11GetPointerRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"\xac\x01\n\rPointerRecord\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\r\n\x05owner\x18\x02 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x03 \x01(\t\x12\x0c\n\x04kind\x18\x04 \x01(\t\x12\x10\n\x08kind_tag\x18\x05 \x01(\r\x12\x0e\n\x06target\x18\x06 \x01(\t\x12\x10\n\x08state_id\x18\x07 \x01(\t\x12\x10\n\x08is_final\x18\x08 \x01(\x08\x12\x16\n\x0etransferred_to\x18\t \x01(\t\"(\n\x15ResolvePointerRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"A\n\x0fPointerResolved\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x10\n\x08kind_tag\x18\x02 \x01(\r\x12\x0e\n\x06target\x18\x03 \x01(\t\")\n\x16PointerFinalityRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"~\n\x11PointerFinalState\x12\x10\n\x08state_id\x18\x01 \x01(\t\x12\x0c\n\x04kind\x18\x02 \x01(\t\x12\x10\n\x08kind_tag\x18\x03 \x01(\r\x12\x0e\n\x06target\x18\x04 \x01(\t\x12\x0f\n\x07holders\x18\x05 \x01(\r\x12\x16\n\x0etransferred_to\x18\x06 \x01(\t\"\x81\x02\n\x0fPointerFinality\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\r\n\x05group\x18\x02 \x01(\r\x12\x10\n\x08\x61nswered\x18\x03 \x01(\r\x12\x0e\n\x06status\x18\x04 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x05 \x01(\t\x12)\n\x05state\x18\x06 \x01(\x0b\x32\x1a.antd.v1.PointerFinalState\x12*\n\x06states\x18\x07 \x03(\x0b\x32\x1a.antd.v1.PointerFinalState\x12,\n\x08majority\x18\x08 \x01(\x0b\x32\x1a.antd.v1.PointerFinalState\x12\x16\n\x0etransferred_to\x18\t \x01(\t\"+\n\x18PointerControllerRequest\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\"G\n\x11PointerController\x12\x0f\n\x07pointer\x18\x01 \x01(\t\x12\x11\n\ttransfers\x18\x02 \x03(\t\x12\x0e\n\x06\x66rozen\x18\x03 \x01(\x08\"\x82\x01\n\x15PreparePointerRequest\x12\r\n\x05owner\x18\x01 \x01(\t\x12\n\n\x02op\x18\x02 \x01(\t\x12\x0e\n\x06target\x18\x03 \x01(\t\x12\x0c\n\x04kind\x18\x04 \x01(\t\x12\x11\n\trecipient\x18\x05 \x01(\t\x12\x1d\n\x15include_signed_quotes\x18\x06 \x01(\x08\"\xc1\x02\n\x16PreparePointerResponse\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12\n\n\x02op\x18\x02 \x01(\t\x12\x0f\n\x07\x61\x64\x64ress\x18\x03 \x01(\t\x12\x10\n\x08state_id\x18\x04 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x05 \x01(\t\x12\x14\n\x0cpayment_type\x18\x06 \x01(\t\x12\'\n\x08payments\x18\x07 \x03(\x0b\x32\x15.antd.v1.PaymentEntry\x12\x14\n\x0ctotal_amount\x18\x08 \x01(\t\x12\x1d\n\x15payment_vault_address\x18\t \x01(\t\x12\x1d\n\x15payment_token_address\x18\n \x01(\t\x12\x0f\n\x07rpc_url\x18\x0b \x01(\t\x12\x30\n\rsigned_quotes\x18\x0c \x03(\x0b\x32\x19.antd.v1.SignedQuoteEntry\"\x9e\x01\n\x16\x46inalizePointerRequest\x12\x11\n\tupload_id\x18\x01 \x01(\t\x12@\n\ttx_hashes\x18\x02 \x03(\x0b\x32-.antd.v1.FinalizePointerRequest.TxHashesEntry\x1a/\n\rTxHashesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"y\n\x17\x46inalizePointerResponse\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x10\n\x08state_id\x18\x02 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x03 \x01(\t\x12*\n\x08\x66inality\x18\x04 \x01(\x0b\x32\x18.antd.v1.PointerFinality2\xeb\x05\n\x0ePointerService\x12M\n\x08ListKeys\x12\x1f.antd.v1.ListPointerKeysRequest\x1a .antd.v1.ListPointerKeysResponse\x12\x45\n\x06\x43reate\x12\x1c.antd.v1.PointerWriteRequest\x1a\x1d.antd.v1.PointerWriteResponse\x12\x45\n\x06Update\x12\x1c.antd.v1.PointerWriteRequest\x1a\x1d.antd.v1.PointerWriteResponse\x12M\n\x08Transfer\x12\x1f.antd.v1.PointerTransferRequest\x1a .antd.v1.PointerTransferResponse\x12\x39\n\x03Get\x12\x1a.antd.v1.GetPointerRequest\x1a\x16.antd.v1.PointerRecord\x12\x43\n\x07Resolve\x12\x1e.antd.v1.ResolvePointerRequest\x1a\x18.antd.v1.PointerResolved\x12\x45\n\x08\x46inality\x12\x1f.antd.v1.PointerFinalityRequest\x1a\x18.antd.v1.PointerFinality\x12K\n\nController\x12!.antd.v1.PointerControllerRequest\x1a\x1a.antd.v1.PointerController\x12J\n\x07Prepare\x12\x1e.antd.v1.PreparePointerRequest\x1a\x1f.antd.v1.PreparePointerResponse\x12M\n\x08\x46inalize\x12\x1f.antd.v1.FinalizePointerRequest\x1a .antd.v1.FinalizePointerResponseBDZ8github.com/WithAutonomi/ant-sdk/antd-go/proto/antd/v1;v1\xaa\x02\x07\x41ntd.V1b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Antd
+  module V1
+    ListPointerKeysRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.ListPointerKeysRequest").msgclass
+    ListPointerKeysResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.ListPointerKeysResponse").msgclass
+    PointerKey = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerKey").msgclass
+    PointerWriteRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerWriteRequest").msgclass
+    PointerWriteResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerWriteResponse").msgclass
+    PointerTransferRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerTransferRequest").msgclass
+    PointerTransferResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerTransferResponse").msgclass
+    GetPointerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.GetPointerRequest").msgclass
+    PointerRecord = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerRecord").msgclass
+    ResolvePointerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.ResolvePointerRequest").msgclass
+    PointerResolved = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerResolved").msgclass
+    PointerFinalityRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerFinalityRequest").msgclass
+    PointerFinalState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerFinalState").msgclass
+    PointerFinality = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerFinality").msgclass
+    PointerControllerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerControllerRequest").msgclass
+    PointerController = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PointerController").msgclass
+    PreparePointerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PreparePointerRequest").msgclass
+    PreparePointerResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.PreparePointerResponse").msgclass
+    FinalizePointerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.FinalizePointerRequest").msgclass
+    FinalizePointerResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("antd.v1.FinalizePointerResponse").msgclass
+  end
+end

data/lib/antd/v1/pointers_services_pb.rb

@@ -0,0 +1,59 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: antd/v1/pointers.proto for package 'antd.v1'
+
+require 'grpc'
+require 'antd/v1/pointers_pb'
+
+module Antd
+  module V1
+    module PointerService
+      # Pointers: owner-signed, paid, mutable references (ADR-0016 in ant-node),
+      # with ownership transfer by final redirection (ADR-0018). Mirrors the REST
+      # `/v1/pointers` surface 1:1.
+      #
+      # antd signs with owner keys it loaded at startup (`--pointer-keys`). A write
+      # names the pointer by its address (`owner`), never by a key; `ListKeys`
+      # lists the pointers this daemon can write.
+      #
+      # Addresses, state ids and targets are 64 hex characters. Counters are
+      # decimal strings: a final state sits at u64::MAX.
+      #
+      # Every write pays, and every attempt pays again. Do not retry Create,
+      # Update or Transfer automatically; a Finalize that fails with
+      # `CLOSE_GROUP_SHORTFALL` is retried by repeating it with the same
+      # `upload_id`, which reuses the payment.
+      class Service
+
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'antd.v1.PointerService'
+
+        rpc :ListKeys, ::Antd::V1::ListPointerKeysRequest, ::Antd::V1::ListPointerKeysResponse
+        # Create a pointer with the daemon wallet. ALREADY_EXISTS if it exists.
+        rpc :Create, ::Antd::V1::PointerWriteRequest, ::Antd::V1::PointerWriteResponse
+        # Point a pointer at a new target with the daemon wallet, creating it if
+        # it does not exist. FAILED_PRECONDITION if the pointer is final.
+        rpc :Update, ::Antd::V1::PointerWriteRequest, ::Antd::V1::PointerWriteResponse
+        # Hand a pointer over to the recipient's pointer for good, with the daemon
+        # wallet. Irreversible once stored.
+        rpc :Transfer, ::Antd::V1::PointerTransferRequest, ::Antd::V1::PointerTransferResponse
+        rpc :Get, ::Antd::V1::GetPointerRequest, ::Antd::V1::PointerRecord
+        # Follow a chain of pointers to the target at its end.
+        rpc :Resolve, ::Antd::V1::ResolvePointerRequest, ::Antd::V1::PointerResolved
+        # Ask the whole close group whether a pointer is final, and on what.
+        rpc :Finality, ::Antd::V1::PointerFinalityRequest, ::Antd::V1::PointerFinality
+        # Follow a pointer's transfers to the pointer whose owner now decides.
+        rpc :Controller, ::Antd::V1::PointerControllerRequest, ::Antd::V1::PointerController
+        # External signer: sign a write with a loaded key and quote it. Mirrors
+        # REST `/v1/pointers/prepare`; the payment shape is ChunkService's.
+        rpc :Prepare, ::Antd::V1::PreparePointerRequest, ::Antd::V1::PreparePointerResponse
+        # External signer: store the prepared write once it is paid.
+        rpc :Finalize, ::Antd::V1::FinalizePointerRequest, ::Antd::V1::FinalizePointerResponse
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/antd/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Antd
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/antd.rb

@@ -5,10 +5,12 @@ require_relative "antd/models"
 require_relative "antd/errors"
 require_relative "antd/discover"
 require_relative "antd/client"
+require_relative "antd/manifests"
 
 # gRPC client is optional — requires the `grpc` gem and proto-generated stubs.
 begin
   require_relative "antd/grpc_client"
+  require_relative "antd/grpc_manifests"
 rescue LoadError
   # grpc gem not installed; GrpcClient not available
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: antd
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - WithAutonomi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc
@@ -97,6 +97,8 @@ files:
 - lib/antd/discover.rb
 - lib/antd/errors.rb
 - lib/antd/grpc_client.rb
+- lib/antd/grpc_manifests.rb
+- lib/antd/manifests.rb
 - lib/antd/models.rb
 - lib/antd/v1/chunks_pb.rb
 - lib/antd/v1/chunks_services_pb.rb
@@ -107,6 +109,10 @@ files:
 - lib/antd/v1/files_services_pb.rb
 - lib/antd/v1/health_pb.rb
 - lib/antd/v1/health_services_pb.rb
+- lib/antd/v1/manifests_pb.rb
+- lib/antd/v1/manifests_services_pb.rb
+- lib/antd/v1/pointers_pb.rb
+- lib/antd/v1/pointers_services_pb.rb
 - lib/antd/v1/upload_pb.rb
 - lib/antd/v1/upload_services_pb.rb
 - lib/antd/v1/wallet_pb.rb