x402-rails 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 411abe38109c401d64e94078fd5b69bb3937b78e7bb6b1518921897ca28ad904
-  data.tar.gz: 2fe5f74f481df1a9b2e74cbd268ad02033d5250f9624eeb7a4912742409a53a5
+  metadata.gz: 1bfc5a5a404b98b156b9c8ad7d833787e5f082eff1b5d5b95e18663a1cb64fc8
+  data.tar.gz: 0bda82b7d122d5b6fbbe6278db1dcd19efda67a6418ee2d8d6a23fb74ecd55fd
 SHA512:
-  metadata.gz: f1bbcaee8f5a30a99fb857f9983bc6ec638d9a6f10c2651e14ab65e3bb68bd4087fac81c5c2db25b1cabd1c92209cb6754a82b369e9f76dbf21998a43cf303c3
-  data.tar.gz: ac5aa6785d6cf1a9284cd4ac776200199d7c53696ae462c3775e226218727be30cbc2acabd39329aec6d8ec6918805fd52b609cddd185262d159b46856817da8
+  metadata.gz: 88f0a27e97ee07b7ae746d7e0ecef9c8676bd8b40544fadead68f6eae5d57b5e318c73edf03645d97670ce197334b596e086d948e92c711ad7fe488f2a1666df
+  data.tar.gz: c5647b5c8ce65f3bbdd2dde221afbd2a27240d77e12ba2f6e0c1387a1b046e170efbdbf5288898cc5b670ea9ee615d92f579e28d4f78b86558787ad5d90ebe77

data/README.md

@@ -17,6 +17,10 @@ Supports Base, avalanche, and other blockchain networks.
 - **Browser paywall** and API support
 - **Rails 7.0+** compatible
 
+## Example Video
+
+https://github.com/user-attachments/assets/05983bb3-7422-4c06-97ab-2fb53d6428cc
+
 ## Installation
 
 Add to your Gemfile:
@@ -155,6 +159,48 @@ end
 | `chain`          | No       | `"base-sepolia"`                 | Blockchain network to use (`base-sepolia`, `base`, `avalanche-fuji`, `avalanche`) |
 | `currency`       | No       | `"USDC"`                         | Payment token symbol (currently only USDC supported)                              |
 | `optimistic`     | No       | `true`                           | Settlement mode (see Optimistic vs Non-Optimistic Mode below)                     |
+| `rpc_urls`       | No       | `{}`                             | Custom RPC endpoint URLs per chain (see Custom RPC URLs below)                    |
+
+### Custom RPC URLs
+
+By default, x402-rails uses public QuickNode RPC endpoints for each supported chain. For production use or higher reliability, you can configure custom RPC URLs from providers like [QuickNode](https://www.quicknode.com/).
+
+**Configuration Priority** (highest to lowest):
+
+1. Programmatic configuration via `config.rpc_urls`
+2. Per-chain environment variables
+3. Built-in default RPC URLs
+
+#### Method 1: Programmatic Configuration
+
+Configure RPC URLs in your initializer:
+
+```ruby
+X402.configure do |config|
+  config.wallet_address = ENV['X402_WALLET_ADDRESS']
+
+  # Custom RPC URLs per chain
+  config.rpc_urls["base"] = "https://your-base-rpc.quiknode.pro/your-key"
+  config.rpc_urls["base-sepolia"] = "https://your-sepolia-rpc.quiknode.pro/your-key"
+  config.rpc_urls["avalanche"] = "https://your-avalanche-rpc.quiknode.pro/your-key"
+end
+```
+
+#### Method 2: Environment Variables
+
+Set per-chain environment variables:
+
+```bash
+# Per-chain RPC URL overrides
+X402_BASE_RPC_URL=https://your-base-rpc.quiknode.pro/your-key
+X402_BASE_SEPOLIA_RPC_URL=https://your-sepolia-rpc.quiknode.pro/your-key
+X402_AVALANCHE_RPC_URL=https://your-avalanche-rpc.quiknode.pro/your-key
+X402_AVALANCHE_FUJI_RPC_URL=https://your-fuji-rpc.quiknode.pro/your-key
+```
+
+#### Method 3: Default RPC URLs
+
+If no custom RPC URL is configured, it will default to the public QuickNode RPC urls.
 
 ## Environment Variables
 
@@ -169,6 +215,12 @@ X402_FACILITATOR_URL=https://x402.org/facilitator
 X402_CHAIN=base-sepolia
 X402_CURRENCY=USDC
 X402_OPTIMISTIC=true  # "true" or "false"
+
+# Custom RPC URLs (optional, per-chain overrides)
+X402_BASE_RPC_URL=https://your-base-rpc.quiknode.pro/your-key
+X402_BASE_SEPOLIA_RPC_URL=https://your-base-speoliarpc.quiknode.pro/your-key
+X402_AVALANCHE_RPC_URL=https://your-avalanche.quiknode.pro/your-key
+X402_AVALANCHE_FUJI_RPC_URL=https://your-fuji-rpc.quiknode.pro/your-key
 ```
 
 ## Examples

data/lib/x402/chains.rb

@@ -5,25 +5,25 @@ module X402
   CHAINS = {
     "base-sepolia" => {
       chain_id: 84532,
-      rpc_url: "https://sepolia.base.org",
+      rpc_url: "https://clean-snowy-hexagon.base-sepolia.quiknode.pro",
       usdc_address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
       explorer_url: "https://sepolia.basescan.org"
     },
     "base" => {
       chain_id: 8453,
-      rpc_url: "https://mainnet.base.org",
+      rpc_url: "https://snowy-compatible-ensemble.base-mainnet.quiknode.pro",
       usdc_address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       explorer_url: "https://basescan.org"
     },
     "avalanche-fuji" => {
       chain_id: 43113,
-      rpc_url: "https://api.avax-test.network/ext/bc/C/rpc",
+      rpc_url: "https://muddy-sly-field.avalanche-testnet.quiknode.pro/ext/bc/C/rpc",
       usdc_address: "0x5425890298aed601595a70AB815c96711a31Bc65",
       explorer_url: "https://testnet.snowtrace.io"
     },
     "avalanche" => {
       chain_id: 43114,
-      rpc_url: "https://api.avax.network/ext/bc/C/rpc",
+      rpc_url: "https://floral-patient-panorama.avalanche-mainnet.quiknode.pro/ext/bc/C/rpc",
       usdc_address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
       explorer_url: "https://snowtrace.io"
     }
@@ -77,5 +77,21 @@ module X402
     def currency_decimals_for_chain(chain_name)
       currency_config_for_chain(chain_name)[:decimals]
     end
+
+    def rpc_url_for(chain_name)
+      # Priority: 1) Programmatic config, 2) ENV variable, 3) Default from CHAINS
+      config = X402.configuration
+
+      # Check programmatic configuration
+      return config.rpc_urls[chain_name] if config.rpc_urls[chain_name]
+
+      # Check environment variable
+      env_var_name = "X402_#{chain_name.upcase.gsub('-', '_')}_RPC_URL"
+      env_rpc = ENV[env_var_name]
+      return env_rpc if env_rpc && !env_rpc.empty?
+
+      # Fall back to default
+      chain_config(chain_name)[:rpc_url]
+    end
   end
 end

data/lib/x402/configuration.rb

@@ -2,7 +2,7 @@
 
 module X402
   class Configuration
-    attr_accessor :wallet_address, :facilitator, :chain, :currency, :optimistic
+    attr_accessor :wallet_address, :facilitator, :chain, :currency, :optimistic, :rpc_urls
 
     def initialize
       @wallet_address = ENV.fetch("X402_WALLET_ADDRESS", nil)
@@ -10,6 +10,7 @@ module X402
       @chain = ENV.fetch("X402_CHAIN", "base-sepolia")
       @currency = ENV.fetch("X402_CURRENCY", "USDC")
       @optimistic = ENV.fetch("X402_OPTIMISTIC", "false") == "true"  # Default to optimistic mode (fast response, settle after)
+      @rpc_urls = {}
     end
 
     def validate!

data/lib/x402/rails/generators/templates/x402_initializer.rb

@@ -19,6 +19,17 @@ X402.configure do |config|
 
   # Currency symbol (currently only USDC is supported)
   config.currency = ENV.fetch("X402_CURRENCY", "USDC")
+
+  # Custom RPC URLs (optional)
+  # Use custom RPC endpoints from providers like QuickNode, Alchemy, or Infura
+  # for better reliability and rate limits. Uncomment and configure as needed:
+  #
+  # config.rpc_urls["base"] = "https://your-base-rpc.quiknode.pro/your-key"
+  # config.rpc_urls["base-sepolia"] = "https://your-sepolia-rpc.quiknode.pro/your-key"
+  # config.rpc_urls["avalanche"] = "https://your-avalanche-rpc.quiknode.pro/your-key"
+  #
+  # Or use environment variables (see README.md for details):
+  # X402_BASE_RPC_URL, X402_BASE_SEPOLIA_RPC_URL, etc.
 end
 
 # Validate configuration on initialization

data/lib/x402/rails/version.rb

@@ -2,6 +2,6 @@
 
 module X402
   module Rails
-    VERSION = "0.1.0"
+    VERSION = "0.2.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: x402-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - QuickNode
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-29 00:00:00.000000000 Z
+date: 2025-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -123,13 +123,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '6.0'
 description: Accept instant blockchain micropayments in Rails applications using the
-  x402 protocol. Enable HTTP 402 Payment Required with USDC payments on Base and other
-  networks.
+  x402 protocol.
 email:
-- zach@quiknode.io
+- zach+x402@quiknode.io
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
 - ".rspec"
 - LICENSE.txt
@@ -156,6 +156,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/quiknode-labs/x402-rails
   source_code_uri: https://github.com/quiknode-labs/x402-rails
+  documentation_uri: https://github.com/quiknode-labs/x402-rails#readme
 post_install_message:
 rdoc_options: []
 require_paths: