x402-rack 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83c112f896c8b38c0ff23082aa0b58acd9ef094f805ff4710b34a0a6bc339f1d
-  data.tar.gz: 3e41ede6ab8a4582218c7827683c54052c623ebcfef02adce42204f55c9d70cc
+  metadata.gz: 0b58759f4b9e4fa2eebbfbe0c683818760b1ca132e4777659f09937699fb0f49
+  data.tar.gz: eb918aae9181e4eeef958e722d9a016eae243a50961a1aa505d9b952c93ac355
 SHA512:
-  metadata.gz: 2480062073f571af1d53fa0d62cea5dd11fd8c4c7990e1d2d7deb67776f87cd024818d59b182c60afa6ef9b46786180b8d87431919a72cb069f0600365c0852c
-  data.tar.gz: 247f58444f749624d7b220085bbb063afde99212df8849b17486cf09534daa590c54ac4d7924b963dc89766c469cf1661ccb356ee65f8b0b3b4bf2fe0d7d7cf7
+  metadata.gz: 57d226beb1d421defa3993bb744947edd021f9c4e1abf435b6b2246aa43bc7f94755dc1548753bf3d894b6a415ff6fced35c97f7df9eb31210503d004c44a2c6
+  data.tar.gz: 9f00ac229e58c2f7c12436760e640de4ffd15767fbb9ee7498bc5a68142d72e5b6ece910701095156694dc73d7fce0d0400ace264582fb105139c025c4334128

data/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.1] - 2026-04-13
+
+### Fixed
+
+- Replace deprecated TAAL ARC endpoints with ARCADE (`arcade.gorillapool.io`, `testnet.arcade.gorillapool.io`) across all e2e specs, docs, and configuration examples (#139)
+
 ## [0.9.0] - 2026-04-13
 
 ### Added

data/README.md

@@ -31,7 +31,7 @@ end
 use X402::Middleware
 ```
 
-ARC defaults to GorillaPool Arcade. The server holds no private keys — it derives unique payment addresses from the remote wallet's public key, broadcasts via ARC, then relays the settlement to the wallet for UTXO tracking.
+ARC defaults to ARCADE. The server holds no private keys — it derives unique payment addresses from the remote wallet's public key, broadcasts via ARC, then relays the settlement to the wallet for UTXO tracking.
 
 ### With a local wallet (enables BRC-121)
 
@@ -60,7 +60,7 @@ end
 use X402::Middleware
 ```
 
-Both PayGateway and BRC121Gateway are auto-enabled. ARC defaults to GorillaPool Arcade.
+Both PayGateway and BRC121Gateway are auto-enabled. ARC defaults to ARCADE.
 
 ### With a remote wallet for all gateways
 
@@ -93,7 +93,7 @@ Clients can pay using whichever protocol they support; the middleware dispatches
 | `BRC105Gateway` (BRC-105) | Yes (local or remote) | `config.enable :brc105_gateway` | Transitional |
 | `ProofGateway` (merkleworks) | No | `config.enable :proof_gateway` | Experimental |
 
-PayGateway is the only gateway that works without a wallet — it derives payment addresses from the operator's public key and relays settlement after broadcast. BRC-121 and BRC-105 require a wallet for `internalize_action`. ARC defaults to GorillaPool Arcade when no explicit `arc_url` is configured.
+PayGateway is the only gateway that works without a wallet — it derives payment addresses from the operator's public key and relays settlement after broadcast. BRC-121 and BRC-105 require a wallet for `internalize_action`. ARC defaults to ARCADE when no explicit `arc_url` is configured.
 
 ## Advanced configuration
 
@@ -159,7 +159,7 @@ Backwards-compat alternatives still work: `config.server_wif = ENV["SERVER_WIF"]
 
 Four BSV settlement schemes are supported:
 
-- **BSV-pay** (Coinbase v2 headers) — server broadcasts via ARC (defaults to GorillaPool Arcade). Partial transaction template, unique derived addresses per payment. Works without a wallet via `operator_wallet_url`.
+- **BSV-pay** (Coinbase v2 headers) — server broadcasts via ARC (defaults to ARCADE). Partial transaction template, unique derived addresses per payment. Works without a wallet via `operator_wallet_url`.
 - **BRC-121** (BSV Association simple) — stateless, BRC-100 wallet-native, zero config.
 - **BRC-105** (BSV Association authenticated) — settlement via `wallet.internalize_action`. Transitional; requires BRC-103 for spec compliance.
 - **BSV-proof** (merkleworks) — experimental; client broadcasts, server checks mempool.

data/docs/ecosystem.md

@@ -56,7 +56,7 @@ These namespaces must not overlap. When designing new headers or gateway types,
 
 **x402-rack is a payment gate, not a wallet.** It verifies payments, broadcasts when required, and relays settlement events to the operator's wallet. It should never hold funds or require private key material on the server.
 
-**PayGateway** implements the Coinbase v2 header spec with BSV as the settlement network — BSV as a first-class citizen in the broader x402 ecosystem. It is the only gateway that works without a wallet: `operator_wallet_url` enables a keyless relay mode where the server derives unique payment addresses from the remote wallet's public key, broadcasts via ARC (defaulting to GorillaPool Arcade), and relays settlement to the wallet for UTXO tracking. With a wallet, PayGateway converges to the same `internalize_action` settlement engine as BRC-121 and BRC-105.
+**PayGateway** implements the Coinbase v2 header spec with BSV as the settlement network — BSV as a first-class citizen in the broader x402 ecosystem. It is the only gateway that works without a wallet: `operator_wallet_url` enables a keyless relay mode where the server derives unique payment addresses from the remote wallet's public key, broadcasts via ARC (defaulting to ARCADE), and relays settlement to the wallet for UTXO tracking. With a wallet, PayGateway converges to the same `internalize_action` settlement engine as BRC-121 and BRC-105.
 
 **BRC121Gateway** implements the BSV Association's simple HTTP payment protocol — stateless, BRC-100 wallet-native, zero config. The most direct path to a working BSV-native x402 server.
 

data/docs/index.md

@@ -38,7 +38,7 @@ end
 use X402::Middleware
 ```
 
-PayGateway is auto-enabled. ARC defaults to GorillaPool Arcade. The server holds no private keys.
+PayGateway is auto-enabled. ARC defaults to ARCADE. The server holds no private keys.
 
 ### With a local wallet (enables BRC-121)
 
@@ -56,7 +56,7 @@ end
 use X402::Middleware
 ```
 
-Both PayGateway and BRC121Gateway are auto-enabled. ARC defaults to GorillaPool Arcade.
+Both PayGateway and BRC121Gateway are auto-enabled. ARC defaults to ARCADE.
 
 ### With a remote wallet for all gateways
 

data/docs/operations/deployment.md

@@ -13,7 +13,7 @@ X402.configure do |config|
 
   config.gateways = [
     X402::BSV::PayGateway.new(
-      arc_client: BSV::Network::ARC.new("https://arc.taal.com", api_key: "..."),
+      arc_client: BSV::Network::ARC.new("https://arcade.gorillapool.io", api_key: "..."),
       payee_locking_script_hex: "76a914...88ac"
     )
   ]
@@ -30,14 +30,13 @@ Both gateways need an ARC endpoint. The `bsv-sdk` provides `BSV::Network::ARC`:
 
 ```ruby
 arc = BSV::Network::ARC.new(
-  "https://arc.taal.com",
+  "https://arcade.gorillapool.io",
   api_key: "your-api-key"
 )
 ```
 
-- **Testnet**: `https://arc-test.taal.com`
-- **Mainnet**: `https://arc.taal.com`
-- **API key**: free for low volume at https://console.taal.com
+- **Testnet**: `https://testnet.arcade.gorillapool.io`
+- **Mainnet**: `https://arcade.gorillapool.io`
 
 ## Rate Limiting
 
@@ -90,5 +89,5 @@ arc = BSV::Network::ARC.new(
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `ARC_URL` | Yes | ARC broadcast endpoint |
-| `ARC_API_KEY` | TAAL requires it | TAAL ARC API key |
+| `ARC_API_KEY` | Optional | ARCADE API key (if required by provider) |
 | `PAYEE_SCRIPT` | Yes | Payee locking script hex |

data/docs/operations/performance.md

@@ -71,7 +71,7 @@ For high-traffic PayGateway deployments, consider HTTP connection pooling to ARC
 ```ruby
 # Use a persistent HTTP client
 http_client = Net::HTTP::Persistent.new
-arc = BSV::Network::ARC.new("https://arc.taal.com",
+arc = BSV::Network::ARC.new("https://arcade.gorillapool.io",
                             api_key: "...",
                             http_client: http_client)
 ```

data/docs/schemes/brc-121.md

@@ -80,7 +80,7 @@ The minimal zero-config setup:
 X402.configure do |c|
   c.domain = "api.example.com"
   c.wallet = X402::Wallet.load       # reads ~/.bsv-wallet/wallet.key
-  c.arc_url = "https://arc.taal.com"
+  c.arc_url = "https://arcade.gorillapool.io"
   c.protect method: :GET, path: "/api/expensive", amount_sats: 100
 end
 

data/lib/x402/configuration.rb

@@ -6,12 +6,10 @@ require_relative "remote_wallet"
 module X402
   # DSL for configuring X402 middleware, gateways, and protected routes.
   #
-  # @example Minimal configuration
+  # @example Minimal configuration (relay mode — no keys on server)
   #   X402.configure do |config|
   #     config.domain = "api.example.com"
-  #     config.server_wif = ENV["SERVER_WIF"]
-  #     config.arc_url = "https://arc.taal.com"
-  #     config.enable :pay_gateway
+  #     config.operator_wallet_url = "https://my-wallet.example.com/api/server-wallet"
   #     config.protect method: :GET, path: "/api/expensive", amount_sats: 100
   #   end
   class Configuration
@@ -396,7 +394,7 @@ module X402
       enable(:pay_gateway) if arc_available?
     end
 
-    # Always true — ARC.default (GorillaPool Arcade) is available even
+    # Always true — ARC.default (ARCADE) is available even
     # when no explicit arc_url is configured. PayGateway is auto-enabled
     # whenever a wallet is present.
     def arc_available?
@@ -407,7 +405,7 @@ module X402
       if arc_url && !arc_url.empty?
         ::BSV::Network::ARC.new(arc_url, api_key: arc_api_key)
       else
-        logger.info "[x402] using default ARC broadcaster (GorillaPool Arcade)"
+        logger.info "[x402] using default ARC broadcaster (ARCADE)"
         ::BSV::Network::ARC.default(testnet: @network == "bsv:testnet")
       end
     end

data/lib/x402/middleware.rb

@@ -12,15 +12,10 @@ module X402
   # to the matching gateway for settlement.
   #
   # @example config.ru
-  #   X402.configure do |config|
-  #     config.domain = "api.example.com"
-  #     config.server_wif = ENV["SERVER_WIF"]
-  #     config.arc_url = "https://arc.taal.com"
-  #     config.enable :pay_gateway
-  #     config.protect method: :GET, path: "/api/expensive", amount_sats: 100
-  #   end
-  #
+  #   X402.configure { |c| c.operator_wallet_url = "https://..." }
   #   use X402::Middleware
+  #
+  # @see X402::Configuration for full configuration options
   class Middleware
     # @param app [#call] next Rack app in the middleware stack
     def initialize(app)

data/lib/x402/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module X402
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: x402-rack
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Simon Bettison