Migration Guide

Managed से Soberano mode में जाएं, versions के बीच upgrade करें, या Lightning providers बदलें — बिना किसी downtime के।

Managed → Soberano (0% fee, full custody)

आपने ManagedProvider से शुरुआत की क्योंकि यह सबसे तेज़ तरीका है। जब आप full custody और 0% fee के लिए तैयार हों, तो migration सिर्फ एक line का काम है।

1. अपना Lightning provider सेट करें

   एक soberano provider चुनें। Blink मुफ़्त है, कोई KYC नहीं, तुरंत setup।

   # Blink: account बनाएं → API Keys → key + wallet ID कॉपी करें
   BLINK_API_KEY=blink_xxxxxxxxxxxxxxxxxxxxxxxx
   BLINK_WALLET_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
   
2. Provider बदलें — एक line

   // Before
   import { ManagedProvider } from 'l402-kit';
   const lightning = ManagedProvider.fromAddress('[e-mail]');
   
   // After
   import { BlinkProvider } from 'l402-kit';
   const lightning = new BlinkProvider(
     process.env.BLINK_API_KEY!,
     process.env.BLINK_WALLET_ID!,
   );
   

   # Before
   from l402kit import ManagedProvider
   lightning = ManagedProvider.from_address("[e-mail]")
   
   # After
   from l402kit.providers.blink import BlinkProvider
   lightning = BlinkProvider(
       api_key=os.environ["BLINK_API_KEY"],
       wallet_id=os.environ["BLINK_WALLET_ID"],
   )
   

   बाकी सब कुछ — middleware setup, token verification, endpoint code — बिल्कुल वैसा ही रहता है।

3. Deploy करें

   Managed provider द्वारा जारी किए गए Tokens migration के बाद काम करते रहते हैं। Verification पूरी तरह crypto पर आधारित है (SHA256(preimage) == paymentHash) — इसका कोई dependency नहीं है कि किस provider ने invoice बनाया।

   कोई migration window नहीं, कोई downtime नहीं, कोई database update नहीं।

ManagedProvider के तहत जारी किए गए already-paid tokens, providers बदलने के बाद भी valid रहते हैं। macaroon में केवल एक hash और एक expiry होती है — कोई provider-specific data नहीं।

---

Soberano providers के बीच बदलाव करें

Same pattern — provider instance बदलें, बाकी कुछ नहीं बदलता।

// Blink → LNbits
import { LNbitsProvider } from 'l402-kit';
const lightning = new LNbitsProvider(
  process.env.LNBITS_KEY!,
  process.env.LNBITS_URL ?? 'https://legend.lnbits.com',
);

// Blink → OpenNode
import { OpenNodeProvider } from 'l402-kit';
const lightning = new OpenNodeProvider(process.env.OPENNODE_KEY!, false);

---

v1.x → v1.8 (current)

कोई breaking changes नहीं। SDK additive है — नए providers, नए agent utilities, नए replay adapters। इससे upgrade करें:

npm install l402-kit@latest
pip install --upgrade l402kit
cargo update l402kit
go get github.com/shinydapps/l402-kit/go@latest

यदि आपने कोई specific version pin की है, तो changelog देखें कि क्या नया है।

---

Framework migration

Express → Fastify

// Express
app.get('/api', l402({ priceSats: 10, lightning }), handler);

// Fastify
import { l402Fastify } from 'l402-kit/fastify';

fastify.get('/api', {
  preHandler: l402Fastify({ priceSats: 10, lightning }),
}, handler);

Express → Hono (Cloudflare Workers)

import { Hono } from 'hono';
import { l402Hono } from 'l402-kit/hono';

const app = new Hono();
app.use('/api/*', l402Hono({ priceSats: 10, lightning }));
app.get('/api/data', (c) => c.json({ data: 'paid' }));

Flask → FastAPI

# Flask
from l402kit.flask import l402_required

@app.route('/api')
@l402_required(price_sats=10, lightning=provider)
def handler():
    return jsonify({'data': 'paid'})

# FastAPI
from l402kit import l402_required

@app.get('/api')
@l402_required(price_sats=10, lightning=provider)
async def handler():
    return {'data': 'paid'}

---

Replay store migration

In-memory → Supabase

Environment variables सेट करें — middleware खुद ही detect करके switch कर लेता है:

SUPABASE_URL=https://xxx.supabase.co
SUPABASE_ANON_KEY=your_anon_key

मौजूदा in-flight tokens काम करते रहते हैं। Supabase store उस क्षण से recording शुरू करता है जब वह active होता है — migrate करने के लिए कोई historical data नहीं है।

In-memory → Redis

import { Redis } from 'ioredis';
import { RedisReplayAdapter } from 'l402-kit';

const redis = new Redis(process.env.REDIS_URL!);

app.get('/api', l402({
  priceSats: 10,
  lightning,
  replayAdapter: new RedisReplayAdapter(redis),
}), handler);

Providers

सभी provider options और setup

Production Guide

Deployment checklist