Practical Implementation: Building Sparkle Protocol

# Download Bitcoin Core wget https://bitcoincore.org/bin/bitcoin-core-28.0/bitcoin-28.0-x86_64-linux-gnu.tar.gz tar -xzf bitcoin-28.0-x86_64-linux-gnu.tar.gz sudo install -m 0755 bitcoin-28.0/bin/* /usr/local/bin/ # Configure bitcoin.conf cat > ~/.bitcoin/bitcoin.conf << EOF server=1 txindex=1 rpcuser=sparkle rpcpassword=sparkle2024 rpcallowip=127.0.0.1 EOF # Start Bitcoin (this takes 2-7 days to sync) bitcoind -daemon # Check sync progress bitcoin-cli getblockchaininfo | grep "verificationprogress"

# Install from binary wget https://github.com/ordinals/ord/releases/download/v0.21.3/ord-linux chmod +x ord-linux sudo mv ord-linux /usr/local/bin/ord # Create ord wallet ord wallet create # Get receive address ord wallet receive # Fund with at least 0.01 BTC for inscriptions # Send BTC to the address above # Start ord server (after Bitcoin syncs) ord server --http-port 8080

# Create new project mkdir sparkle-protocol cd sparkle-protocol npm init -y # Install spark.money SDK npm install @buildonspark/spark-sdk # Install other dependencies npm install express ws bitcoin-lib

# Create spark integration file cat > spark-integration.js << 'EOF' import { SparkWallet } from "@buildonspark/spark-sdk"; export async function initializeSpark() { const { wallet } = await SparkWallet.initialize({ options: { network: "MAINNET" } }); return wallet; } export async function createInvoice(wallet, amount, memo) { return await wallet.createInvoice({ amountSats: amount, description: memo, expirationSecs: 3600 }); } export async function payInvoice(wallet, invoice) { return await wallet.payInvoice({ encodedInvoice: invoice, preferSpark: true }); } EOF

# Inscribe first background ord wallet inscribe --fee-rate 10 --file sparkle-layers/backgrounds/01_background_dark.svg # Output: Inscription ID: abc123... # Save inscription ID echo "01_background_dark: abc123..." >> inscription-ids.txt # Repeat for ALL 200 layers # This will cost approximately 0.005 BTC total

# Create NFT #1 metadata cat > nft_001.json << 'EOF' { "p": "sparkle", "v": 1, "name": "Sparkle #001", "traits": { "background": "/content/abc123...", "body": "/content/def456...", "eyes": "/content/ghi789...", "mouth": "/content/jkl012..." }, "lightning": { "enabled": true, "node": "spark.money" } } EOF # Inscribe the NFT (500 bytes = $0.05) ord wallet inscribe --fee-rate 10 --file nft_001.json

# indexer.js - This doesn't exist, you must build it cat > indexer.js << 'EOF' const { Client } = require('pg'); const axios = require('axios'); class SparkleIndexer { constructor() { this.db = new Client({ host: 'localhost', database: 'sparkle', user: 'sparkle', password: 'sparkle' }); } async scanInscriptions() { // Connect to ord API const response = await axios.get('http://localhost:8080/inscriptions'); for (const inscription of response.data) { // Check if it's a Sparkle protocol inscription const content = await this.fetchContent(inscription.id); if (content.p === 'sparkle' && content.v === 4) { // It's a Sparkle NFT! Index it await this.indexSparkle(inscription.id, content); } } } async indexSparkle(id, content) { // Save to database await this.db.query( 'INSERT INTO sparkle_nfts (inscription_id, metadata, lightning_enabled) VALUES ($1, $2, $3)', [id, JSON.stringify(content), content.lightning?.enabled] ); } } // Run indexer const indexer = new SparkleIndexer(); indexer.scanInscriptions(); EOF

# trading-api.js cat > trading-api.js << 'EOF' const express = require('express'); const { SparkWallet } = require('@buildonspark/spark-sdk'); const app = express(); app.use(express.json()); // Initialize Spark let sparkWallet; (async () => { const { wallet } = await SparkWallet.initialize({ options: { network: "MAINNET" } }); sparkWallet = wallet; })(); // Trade endpoint app.post('/api/trade', async (req, res) => { const { nftId, sellerAddress, buyerAddress, price } = req.body; try { // Step 1: Create Lightning invoice const invoice = await sparkWallet.createInvoice({ amountSats: price, description: `NFT Trade: ${nftId}` }); // Step 2: Wait for payment const payment = await sparkWallet.waitForPayment(invoice.paymentRequest); if (payment.status === 'SUCCEEDED') { // Step 3: Transfer NFT on-chain // This requires building PSBT and signing const transferTx = await createTransferTransaction(nftId, buyerAddress); res.json({ success: true, invoice: invoice.paymentRequest, transferTx: transferTx }); } } catch (error) { res.status(500).json({ error: error.message }); } }); app.listen(3000); EOF

# This would be a browser extension or wallet fork # Currently NO wallet supports this # wallet-plugin.js (conceptual) cat > wallet-plugin.js << 'EOF' class SparkleWalletPlugin { constructor(wallet) { this.wallet = wallet; this.spark = null; } async detectSparkleNFT(inscriptionId) { // Fetch inscription content const content = await fetch(`/inscription/${inscriptionId}`).then(r => r.json()); // Check if it's Sparkle protocol return content.p === 'sparkle' && content.v === 4; } async enableLightningTrade(nftId) { if (!this.spark) { // Initialize spark.money connection this.spark = await SparkWallet.initialize(); } // Show Lightning trade button in UI this.wallet.ui.showLightningOption(nftId); } } EOF

# This requires forking Magic Eden or similar # They need to add this detection code: // marketplace-sparkle-detector.js function detectSparkleProtocol(inscription) { try { const metadata = JSON.parse(inscription.content); if (metadata.p === 'sparkle' && metadata.v === 4) { return { isSparkle: true, lightningEnabled: metadata.lightning?.enabled || false, traits: metadata.traits }; } } catch (e) { // Not JSON or not Sparkle } return { isSparkle: false }; } // Add badge to UI if (detectSparkleProtocol(nft).isSparkle) { nftElement.addBadge('⚡ Lightning Enabled'); }

# If this was working, here's what you'd see: # 1. Inscribe test layer on testnet ord --testnet wallet inscribe --fee-rate 1 --file test-background.svg # Output: abc123testnetinscriptionid... # 2. Create test NFT echo '{ "p": "sparkle", "v": 1, "traits": ["/content/abc123testnetinscriptionid..."] }' | ord --testnet wallet inscribe --fee-rate 1 --file - # 3. Check it exists curl http://localhost:8080/inscription/[inscription_id] # 4. NO MARKETPLACE WOULD SHOW IT # because no one has built the indexer