Integrating SUBTC Protocol with IPFS Sites — Overview

The SUBTC Protocol can seamlessly integrate with IPFS-hosted websites, particularly static sites, to enable Bitcoin payments and wallet management. Static pages make it easy to use curl or lightweight scripts to interact with the API.

Base API: https://subtc.net/api

🌐 Why IPFS + SUBTC Works

• IPFS sites are usually static (HTML, JavaScript minimal)

• No complex server-side backend is required

• SUBTC API can be called directly using HTTP requests or curl

• Works well for developers, AI agents, and automated scripts

⚙️ Integration Approach

1. Frontend (IPFS Page)

• HTML or JavaScript page serves as the user interface

• Example: “Buy digital content” button triggers API call

1. Backend / API Calls

• Use curl from static pages (via JS fetch + CORS proxy if needed)

• SUBTC API handles wallet creation, receiving addresses, and BTC transfers

1. Wallet Flow Example

# Create Wallet
curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_create" \
-H "X-SUBTC-KEY: $KEY" \
-H "Content-Type: application/json" \
-d '{}'

# Receive Payment
curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_receive" \
-H "X-SUBTC-KEY: $KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_id":"<wallet_id>"}'

# Send BTC
curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_send" \
-H "X-SUBTC-KEY: $KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_id":"<wallet_id>","to":"","amount_sat":10000}'

1. Event Monitoring

Poll payments or use webhook style via wallet_wait_event

Updates can be shown directly on the IPFS site with minimal JavaScript

💡 Notes for IPFS Developers

No RPC needed: SUBTC handles blockchain interactions

Static-friendly: IPFS pages don’t require dynamic server processing

Secure keys: Keep X-SUBTC-KEY in an environment file or proxy layer

Supports AI integration: Use AI agents to automate payments or monitor transactions

🧩 Use Cases

Sell digital art or NFTs hosted on IPFS

Collect donations via BTC

Build micro-payments for content access

Automated reward systems for IPFS-hosted apps

Conclusion

Integrating SUBTC Protocol with IPFS sites offers a lightweight, secure, and scalable solution for Bitcoin payments. Static pages, minimal scripting, and curl commands are sufficient to:

Create wallets

Receive and send BTC

Monitor transactions

This makes SUBTC ideal for decentralized web projects and experimental Bitcoin payment platforms.