remitmd 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d343ece392d469fe2aa4c2388d912506654744486007eabc5dd8f030e19c00e3
-  data.tar.gz: 7b5ff1660f2dc09b105db50d29c0d9ffa6085a0537e1dce8faf3b6546de6c817
+  metadata.gz: 77a3a0333d3f1afc8315ad1d523bc9adb70e74d2f5af29bc20b608233b0f67b1
+  data.tar.gz: b04b273b6340c25f8adcc5e755e99a4f32c9e804aec91d2e28058a66f507e9e9
 SHA512:
-  metadata.gz: 238bc729c10f5e79104d6d139dff95fc87aaa824f4a6dc75bf024c63ced60f2f86b5d1a01ae16c8a47418e8ab37d4443a940c63bfd1f6424d65fba46e96b5c88
-  data.tar.gz: ac95ef3316ad9684c6e8996fb0704a23423a77fa4083f98e70d1294c2157a91fda366214aaded0f8648241dabfc41ae7b92b2056f7690a0a8e467ebc8b5fac72
+  metadata.gz: 3e343856eb6688f7a5bee1a10fa85ae119e9ac548eeedfb4bb95a21f4a5565d8ad4921efccfcad940f3f8a89fb7a0fd313243c7dd511f132c0540b69e05b2f82
+  data.tar.gz: 284848e90b0c9c53bc80a07fa7a2bc90ea7f3e1afef282b10308a9fc5805b9c750392d75a6055bf152660d15a1b3948d06fddbf179f5daf2ae3b586f0e18a35a

data/README.md

@@ -1,5 +1,7 @@
 # remit.md Ruby SDK
 
+> [Skill MD](https://remit.md) · [Docs](https://remit.md/docs) · [Agent Spec](https://remit.md/agent.md)
+
 Universal payment protocol for AI agents — Ruby client library.
 
 [![CI](https://github.com/remit-md/sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/remit-md/sdk/actions/workflows/ci.yml)
@@ -38,7 +40,7 @@ Or from environment variables:
 ```ruby
 wallet = Remitmd::RemitWallet.from_env
 # Requires: REMITMD_PRIVATE_KEY
-# Optional: REMITMD_CHAIN (default: "base"), REMITMD_API_URL, REMITMD_RPC_URL
+# Optional: REMITMD_CHAIN (default: "base"), REMITMD_API_URL
 ```
 
 Permits are auto-signed. Every payment method fetches the on-chain USDC nonce, signs an EIP-2612 permit, and includes it automatically.
@@ -267,19 +269,6 @@ permit = wallet.sign_usdc_permit(
 tx = wallet.pay("0xRecipient...", 5.00, permit: permit)
 ```
 
-### Custom RPC URL
-
-Override the JSON-RPC endpoint used for nonce fetching:
-
-```ruby
-wallet = Remitmd::RemitWallet.new(
-  private_key: key,
-  chain: "base_sepolia",
-  rpc_url: "https://your-rpc-provider.com/v1/base-sepolia"
-)
-# Or via environment: REMITMD_RPC_URL
-```
-
 ## License
 
 MIT — see [LICENSE](LICENSE)

data/lib/remitmd/errors.rb

@@ -30,12 +30,12 @@ module Remitmd
     SERVER_ERROR            = "SERVER_ERROR"
     NONCE_REUSED            = "NONCE_REUSED"
     SIGNATURE_INVALID       = "SIGNATURE_INVALID"
-    ESCROW_ALREADY_RELEASED = "ESCROW_ALREADY_RELEASED"
+    ESCROW_ALREADY_COMPLETED = "ESCROW_ALREADY_COMPLETED"
     ESCROW_EXPIRED          = "ESCROW_EXPIRED"
     TAB_LIMIT_EXCEEDED      = "TAB_LIMIT_EXCEEDED"
     BOUNTY_ALREADY_AWARDED  = "BOUNTY_ALREADY_AWARDED"
     STREAM_NOT_ACTIVE       = "STREAM_NOT_ACTIVE"
-    DEPOSIT_ALREADY_SETTLED = "DEPOSIT_ALREADY_SETTLED"
+    DEPOSIT_ALREADY_RESOLVED = "DEPOSIT_ALREADY_RESOLVED"
     USDC_TRANSFER_FAILED    = "USDC_TRANSFER_FAILED"
     CHAIN_UNAVAILABLE       = "CHAIN_UNAVAILABLE"
 

data/lib/remitmd/http.rb

@@ -8,9 +8,11 @@ require "openssl"
 
 module Remitmd
   # Chain configuration: maps chain names to (api_url, chain_id) pairs.
+  # Canonical keys use hyphens; underscored variants are accepted as aliases.
   CHAIN_CONFIG = {
-    "base"          => { url: "https://remit.md/api/v1",          chain_id: 8453 },
-    "base_sepolia"  => { url: "https://testnet.remit.md/api/v1",      chain_id: 84532 },
+    "base"          => { url: "https://remit.md/api/v1",             chain_id: 8453 },
+    "base-sepolia"  => { url: "https://testnet.remit.md/api/v1",    chain_id: 84532 },
+    "base_sepolia"  => { url: "https://testnet.remit.md/api/v1",    chain_id: 84532 },
   }.freeze
 
   # HTTP transport layer. Signs each request with EIP-712 auth headers and
@@ -40,9 +42,11 @@ module Remitmd
 
     def request(method, path, body)
       attempt = 0
+      # Generate idempotency key once per request (stable across retries).
+      idempotency_key = (method == :post || method == :put || method == :patch) ? SecureRandom.uuid : nil
       begin
         attempt += 1
-        req  = build_request(method, path, body)
+        req  = build_request(method, path, body, idempotency_key)
         resp = @http.request(req)
         handle_response(resp, path)
       rescue RemitError => e
@@ -58,7 +62,7 @@ module Remitmd
       end
     end
 
-    def build_request(method, path, body)
+    def build_request(method, path, body, idempotency_key = nil)
       full_path = "#{@uri.path}#{path}"
       req = case method
             when :get  then Net::HTTP::Get.new(full_path)
@@ -81,6 +85,7 @@ module Remitmd
       req["X-Remit-Nonce"]     = nonce_hex
       req["X-Remit-Timestamp"] = timestamp.to_s
       req["X-Remit-Signature"] = signature
+      req["X-Idempotency-Key"] = idempotency_key if idempotency_key
 
       if body
         req.body = body.to_json

data/lib/remitmd/mock.rb

@@ -148,7 +148,6 @@ module Remitmd
           "deposit"        => "0xMockDeposit00000000000000000000000001",
           "fee_calculator" => "0xMockFeeCalc0000000000000000000000001",
           "key_registry"   => "0xMockKeyReg000000000000000000000000001",
-          "arbitration"    => "0xMockArbitr000000000000000000000000001",
         }
 
       # Balance
@@ -200,7 +199,7 @@ module Remitmd
       in ["POST", path] if path.end_with?("/release") && path.include?("/escrows/")
         id  = extract_id(path, "/escrows/", "/release")
         esc = @state[:escrows].fetch(id) { raise not_found(RemitError::ESCROW_NOT_FOUND, id) }
-        new_esc = update_escrow(esc, status: EscrowStatus::RELEASED)
+        new_esc = update_escrow(esc, status: EscrowStatus::COMPLETED)
         @state[:escrows][id] = new_esc
         tx = make_tx(from: esc.payer, to: esc.payee, amount: esc.amount)
         @state[:transactions] << tx
@@ -269,7 +268,7 @@ module Remitmd
       in ["POST", path] if path.end_with?("/close") && path.include?("/tabs/")
         id  = extract_id(path, "/tabs/", "/close")
         tab = @state[:tabs].fetch(id) { raise not_found(RemitError::TAB_NOT_FOUND, id) }
-        new_tab = update_tab(tab, status: TabStatus::SETTLED)
+        new_tab = update_tab(tab, status: TabStatus::CLOSED)
         @state[:tabs][id] = new_tab
         tab_hash(new_tab)
 

data/lib/remitmd/models.rb

@@ -16,29 +16,30 @@ module Remitmd
   module EscrowStatus
     PENDING   = "pending"
     FUNDED    = "funded"
-    RELEASED  = "released"
+    ACTIVE    = "active"
+    COMPLETED = "completed"
     CANCELLED = "cancelled"
-    EXPIRED   = "expired"
+    FAILED    = "failed"
   end
 
   module TabStatus
     OPEN    = "open"
     CLOSED  = "closed"
-    SETTLED = "settled"
+    EXPIRED = "expired"
   end
 
   module StreamStatus
     ACTIVE    = "active"
-    PAUSED    = "paused"
-    ENDED     = "ended"
-    CANCELLED = "cancelled"
+    CLOSED    = "closed"
+    COMPLETED = "completed"
   end
 
   module BountyStatus
     OPEN      = "open"
+    CLAIMED   = "claimed"
     AWARDED   = "awarded"
     EXPIRED   = "expired"
-    RECLAIMED = "reclaimed"
+    CANCELLED = "cancelled"
   end
 
   module DepositStatus
@@ -116,12 +117,11 @@ module Remitmd
       @deposit        = h["deposit"]
       @fee_calculator = h["fee_calculator"]
       @key_registry   = h["key_registry"]
-      @arbitration    = h["arbitration"]
       @relayer        = h["relayer"]
     end
 
     attr_reader :chain_id, :usdc, :router, :escrow, :tab, :stream,
-                :bounty, :deposit, :fee_calculator, :key_registry, :arbitration,
+                :bounty, :deposit, :fee_calculator, :key_registry,
                 :relayer
   end
 

data/lib/remitmd/wallet.rb

@@ -2,25 +2,16 @@
 
 require "bigdecimal"
 require "bigdecimal/util"
-require "net/http"
-require "uri"
 require "json"
 
 module Remitmd
   # Known USDC contract addresses per chain (EIP-2612 compatible).
   USDC_ADDRESSES = {
-    "base-sepolia" => "0x142aD61B8d2edD6b3807D9266866D97C35Ee0317",
+    "base-sepolia" => "0x2d846325766921935f37d5b4478196d3ef93707c",
     "base" => "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "localhost" => "0x5FbDB2315678afecb367f032d93F642f64180aa3",
   }.freeze
 
-  # Default JSON-RPC endpoints per chain (for nonce fetching).
-  DEFAULT_RPC_URLS = {
-    "base-sepolia" => "https://sepolia.base.org",
-    "base" => "https://mainnet.base.org",
-    "localhost" => "http://127.0.0.1:8545",
-  }.freeze
-
   # Primary remit.md client. All payment operations are methods on RemitWallet.
   #
   # @example Quickstart
@@ -39,16 +30,14 @@ module Remitmd
     # @param signer [Signer, nil]      custom signer (pass instead of private_key)
     # @param chain [String]            chain name — "base", "base_sepolia"
     # @param api_url [String, nil]     override API base URL
-    # @param rpc_url [String, nil]     override JSON-RPC URL for on-chain queries
     # @param transport [Object, nil]   inject mock transport (used by MockRemit)
-    def initialize(private_key: nil, signer: nil, chain: "base", api_url: nil, router_address: nil, rpc_url: nil, transport: nil)
+    def initialize(private_key: nil, signer: nil, chain: "base", api_url: nil, router_address: nil, transport: nil)
       if transport
         # MockRemit path: transport + signer injected directly
         @signer    = signer
         @transport = transport
         @chain_key = "base-sepolia"
         @chain_id  = ChainId::BASE_SEPOLIA
-        @rpc_url   = DEFAULT_RPC_URLS["base-sepolia"]
         @mock_mode = true
         return
       end
@@ -61,7 +50,7 @@ module Remitmd
       end
 
       @signer = signer || PrivateKeySigner.new(private_key)
-      # Normalize chain key for USDC/RPC lookups (underscore → hyphen).
+      # Normalize chain key for USDC lookups (underscore → hyphen).
       @chain_key = chain.tr("_", "-")
       # Normalize to the base chain name (strip testnet suffix) for use in pay body.
       # The server accepts "base" — not "base_sepolia" etc.
@@ -72,7 +61,6 @@ module Remitmd
       base_url       = api_url || cfg[:url]
       @chain_id      = cfg[:chain_id]
       router_address ||= ""
-      @rpc_url = rpc_url || ENV["REMITMD_RPC_URL"] || DEFAULT_RPC_URLS[@chain_key] || DEFAULT_RPC_URLS["base-sepolia"]
       @transport = HttpTransport.new(
         base_url:       base_url,
         signer:         @signer,
@@ -82,14 +70,19 @@ module Remitmd
     end
 
     # Build a RemitWallet from environment variables.
-    # Reads: REMITMD_PRIVATE_KEY, REMITMD_CHAIN, REMITMD_API_URL, REMITMD_ROUTER_ADDRESS, REMITMD_RPC_URL.
+    # Reads: REMITMD_KEY (primary) or REMITMD_PRIVATE_KEY (deprecated fallback),
+    # REMITMD_CHAIN, REMITMD_API_URL, REMITMD_ROUTER_ADDRESS.
     def self.from_env
-      key            = ENV.fetch("REMITMD_PRIVATE_KEY") { raise ArgumentError, "REMITMD_PRIVATE_KEY not set" }
+      key = ENV["REMITMD_KEY"] || ENV["REMITMD_PRIVATE_KEY"]
+      if ENV["REMITMD_PRIVATE_KEY"] && !ENV["REMITMD_KEY"]
+        warn "[remitmd] REMITMD_PRIVATE_KEY is deprecated, use REMITMD_KEY instead"
+      end
+      raise ArgumentError, "REMITMD_KEY not set" unless key
+
       chain          = ENV.fetch("REMITMD_CHAIN", "base")
       api_url        = ENV["REMITMD_API_URL"]
       router_address = ENV["REMITMD_ROUTER_ADDRESS"]
-      rpc_url        = ENV["REMITMD_RPC_URL"]
-      new(private_key: key, chain: chain, api_url: api_url, router_address: router_address, rpc_url: rpc_url)
+      new(private_key: key, chain: chain, api_url: api_url, router_address: router_address)
     end
 
     # The Ethereum address associated with this wallet.
@@ -350,7 +343,15 @@ module Remitmd
     # @param usdc_address [String, nil] override the USDC contract address
     # @return [PermitSignature]
     def sign_usdc_permit(spender, value, deadline, nonce = 0, usdc_address: nil)
-      usdc_addr = usdc_address || USDC_ADDRESSES[@chain_key] || ""
+      usdc_addr = usdc_address || USDC_ADDRESSES[@chain_key]
+      if usdc_addr.nil? || usdc_addr.empty?
+        raise RemitError.new(
+          RemitError::INVALID_ADDRESS,
+          "No USDC address configured for chain #{@chain_key.inspect}. " \
+          "Valid chains: #{USDC_ADDRESSES.keys.join(", ")}",
+          context: { chain: @chain_key }
+        )
+      end
       chain_id = @chain_id || ChainId::BASE_SEPOLIA
 
       # Domain separator for USDC (EIP-2612)
@@ -397,8 +398,16 @@ module Remitmd
     # @param deadline [Integer, nil] optional Unix timestamp; defaults to 1 hour from now
     # @return [PermitSignature]
     def sign_permit(spender, amount, deadline: nil)
-      usdc_addr = USDC_ADDRESSES[@chain_key] || ""
-      nonce = fetch_usdc_nonce(usdc_addr)
+      usdc_addr = USDC_ADDRESSES[@chain_key]
+      if usdc_addr.nil? || usdc_addr.empty?
+        raise RemitError.new(
+          RemitError::INVALID_ADDRESS,
+          "No USDC address configured for chain #{@chain_key.inspect}. " \
+          "Valid chains: #{USDC_ADDRESSES.keys.join(", ")}",
+          context: { chain: @chain_key }
+        )
+      end
+      nonce = fetch_permit_nonce(usdc_addr)
       dl = deadline || (Time.now.to_i + 3600)
       raw = (amount * 1_000_000).round.to_i
       sign_usdc_permit(spender, raw, dl, nonce, usdc_address: usdc_addr)
@@ -572,8 +581,8 @@ module Remitmd
       begin
         resolved = permit || auto_permit("relayer", 999_999_999.0)
         body[:permit] = resolved.to_h
-      rescue StandardError
-        # permit signing failed — proceed without permit (custodial fallback)
+      rescue StandardError => e
+        warn "[remitmd] create_fund_link: auto-permit failed: #{e.message}"
       end
       LinkResponse.new(@transport.post("/links/fund", body))
     end
@@ -590,8 +599,8 @@ module Remitmd
       begin
         resolved = permit || auto_permit("relayer", 999_999_999.0)
         body[:permit] = resolved.to_h
-      rescue StandardError
-        # permit signing failed — proceed without permit (custodial fallback)
+      rescue StandardError => e
+        warn "[remitmd] create_withdraw_link: auto-permit failed: #{e.message}"
       end
       LinkResponse.new(@transport.post("/links/withdraw", body))
     end
@@ -652,41 +661,23 @@ module Remitmd
 
     # ─── Permit helpers ──────────────────────────────────────────────────
 
-    # Fetch the current EIP-2612 nonce for this wallet from the USDC contract.
-    # Uses JSON-RPC eth_call with selector 0x7ecebe00 (nonces(address)).
+    # Fetch the EIP-2612 permit nonce from the API.
     # @param usdc_address [String] the USDC contract address
     # @return [Integer] current nonce
-    def fetch_usdc_nonce(usdc_address)
+    def fetch_permit_nonce(usdc_address)
       return 0 if @mock_mode
 
-      padded = address.downcase.delete_prefix("0x").rjust(64, "0")
-      data = "0x7ecebe00#{padded}"
-      payload = {
-        jsonrpc: "2.0",
-        id: 1,
-        method: "eth_call",
-        params: [{ to: usdc_address, data: data }, "latest"]
-      }
-
-      uri = URI.parse(@rpc_url)
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = (uri.scheme == "https")
-      http.read_timeout = 10
-      http.open_timeout = 5
-
-      req = Net::HTTP::Post.new(uri.request_uri)
-      req["Content-Type"] = "application/json"
-      req.body = payload.to_json
-
-      resp = http.request(req)
-      result = JSON.parse(resp.body)
-
-      if result["error"]
-        msg = result["error"].is_a?(Hash) ? result["error"]["message"] : result["error"].to_s
-        raise RemitError.new(RemitError::NETWORK_ERROR, "RPC error fetching nonce: #{msg}")
+      data = @transport.get("/status/#{address}")
+      nonce = data.is_a?(Hash) ? data["permit_nonce"] : nil
+      if nonce.nil?
+        raise RemitError.new(
+          RemitError::NETWORK_ERROR,
+          "permit_nonce not available from API for #{address}. " \
+          "Ensure the server supports the permit_nonce field in GET /api/v1/status.",
+          context: { address: address }
+        )
       end
-
-      (result["result"] || "0x0").to_i(16)
+      nonce.to_i
     end
 
     # Auto-sign a permit for the given contract type and amount.

data/lib/remitmd.rb

@@ -22,5 +22,5 @@ require_relative "remitmd/mock"
 #   mock.was_paid?("0x0000000000000000000000000000000000000001", 1.00) # => true
 #
 module Remitmd
-  VERSION = "0.1.4"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: remitmd
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - remit.md
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-22 00:00:00.000000000 Z
+date: 2026-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec