[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6},"actionData","errors","routes/hashtag",{"_7":8,"_9":10,"_11":12},"articles",[13],"authors",{},"tag","vending",{"_14":15,"_16":17,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27},"content","# Kapnet Metering & Vending Protocol\n\n## Philosophy\n\nEvery byte costs sats. Every computation costs sats. Every coordination act costs sats. This is not a bug — it's the feature. Scarcity creates value. Metering creates sustainability.\n\n## Postage Model\n\nEvery TXXM submitted to a Kapnet relay requires postage. This is NOT a fee to Pluronymous LLC — it's a proof-of-work-style spam prevention mechanism that creates an internal economy.\n\n### Postage Rates (in satoshis)\n\n| Operation | Base Rate | Notes |\n|-----------|-----------|-------|\n| Public note (kind-1) | 1 sat | Minimum viable post |\n| TXXM submission (kind-30078) | 10 sats | Standard coordination act |\n| Wiki page publish (kind-30023) | 100 sats | Long-form content |\n| KOR creation | 1,000 sats | Namespace registration |\n| SubKOR creation | 100 sats | Under existing KOR |\n| Membership grant | 50 sats | Per membership TXXM |\n| Cross-KOR TXXM | 25 sats | Inter-namespace routing |\n| Encrypted group message | 5 sats | Per MLS message |\n| Blob upload (per KB) | 1 sat | Content-addressed storage |\n| Search query | 1 sat | State tree search |\n| Knot checkpoint | 500 sats | Braid checkpoint |\n| Governance vote | 10 sats | Per vote TXXM |\n| Support ticket | 100 sats | Human-assisted resolution |\n\n### Dynamic Pricing\n\nPostage rates adjust based on network load:\n\n```\nbase_rate × load_multiplier = actual_rate\n\nload_multiplier = max(1, current_txxms_per_hour / target_txxms_per_hour)\n\ntarget_txxms_per_hour = 1000 (configurable per relay)\n```\n\nWhen the network is busy, prices go up. When it's quiet, prices go down. This is automatic and deterministic.\n\n## Hedlbit Accounting\n\nHedlbits are the internal accounting unit. They are NOT a token — they are a proof-of-work credit that can be earned and burned.\n\n### Earning Hedlbits\n\n| Activity | Hedlbits Earned |\n|----------|----------------|\n| Validate a TXXM | 1 per validation |\n| Store blob (per KB per day) | 0.1 per KB-day |\n| Relay TXXM to peer | 0.5 per relay |\n| Knot checkpoint creation | 10 per knot |\n| Governance participation | 5 per vote |\n| Bug report (verified) | 100 per report |\n| Code contribution | 100-10000 per PR |\n| Documentation | 10-100 per page |\n| Peer discovery | 5 per new peer |\n| Co-specification | 50 per spec |\n\n### Burning Hedlbits\n\n| Action | Hedlbits Burned |\n|--------|-----------------|\n| Membership upgrade | 1000 per tier-month |\n| Priority relay access | 100 per hour |\n| Dedicated support | 500 per ticket |\n| Custom KOR governance | 2000 one-time |\n| Encrypted group creation | 500 per group |\n| Blob pinning (per KB per month) | 10 per KB-month |\n| Cross-KOR bridge | 1000 one-time |\n\n### Hedlbit ↔ Satoshi Exchange\n\n```\n1 Hedlbit = 1 satoshi (fixed rate)\n\nHedlbits can be:\n• Earned through work (validation, storage, research)\n• Burned for services (membership, priority, support)\n• Traded peer-to-peer (OTC, no DEX)\n• Converted to sats (via Pluronymous treasury, 1:1)\n```\n\n## Vending Machine Protocol\n\nA vending machine is a TXXM-based store that sells digital goods for sats. Anyone can create a vending machine.\n\n### Vending Machine TXXM Format\n\n```json\n{\n \"type\": \"vending-machine\",\n \"version\": \"1.0\",\n \"machine_id\": \"unique-id\",\n \"kor\": \"namespace\",\n \"operator\": \"\",\n \"inventory\": [\n {\n \"item_id\": \"item-001\",\n \"name\": \"Kapnet Starter Guide\",\n \"description\": \"PDF guide for new Kapnet participants\",\n \"price_sats\": 500,\n \"price_hedlbits\": 500,\n \"content_type\": \"application/pdf\",\n \"content_cid\": \"bafybeigzm47a4hrwfxusmrwrj3dgsq4j6xgcbntvnobkarlsmzgjr4hnmm\",\n \"access_grant\": {\n \"kor\": \"sys.pluronymous.org\",\n \"tier\": \"member\",\n \"duration_days\": 30\n }\n }\n ],\n \"payment_methods\": [\"lightning\", \"hedlbit\"],\n \"created\": \"\"\n}\n```\n\n### Purchase Flow\n\n1. **Browse**: Client queries vending machine TXXMs from relay\n2. **Select**: User selects item and creates purchase TXXM\n3. **Invoice**: Vending machine generates Lightning invoice\n4. **Pay**: User pays via Lightning wallet\n5. **Deliver**: Vending machine publishes delivery TXXM with encrypted content\n6. **Access**: User decrypts content and gains access grant\n\n### Delivery TXXM\n\n```json\n{\n \"type\": \"vending-delivery\",\n \"machine_id\": \"unique-id\",\n \"item_id\": \"item-001\",\n \"buyer_npub\": \"\",\n \"payment_proof\": \"\",\n \"encrypted_content\": \"\",\n \"access_grant\": {\n \"kor\": \"sys.pluronymous.org\",\n \"tier\": \"member\",\n \"granted_at\": \"\",\n \"expires_at\": \"\"\n }\n}\n```\n\n## Support Ticket Protocol\n\nSupport tickets are TXXM-based requests for human assistance. They cost sats and are tracked in a KOR.\n\n### Ticket TXXM\n\n```json\n{\n \"type\": \"support-ticket\",\n \"version\": \"1.0\",\n \"ticket_id\": \"TKT-001\",\n \"kor\": \"sys.pluronymous.org/support\",\n \"requester\": \"\",\n \"category\": \"technical|membership|governance|billing|other\",\n \"priority\": \"low|medium|high|urgent\",\n \"subject\": \"Brief description\",\n \"description\": \"Detailed description\",\n \"postage_paid\": 100,\n \"status\": \"open\",\n \"created\": \"\"\n}\n```\n\n### Ticket Pricing\n\n| Category | Base Postage | Resolution Time |\n|----------|-------------|-----------------|\n| Technical | 100 sats | 48 hours |\n| Membership | 50 sats | 24 hours |\n| Governance | 200 sats | 7 days |\n| Billing | 50 sats | 24 hours |\n| Urgent | 500 sats | 4 hours |\n\n### Ticket Lifecycle\n\n1. **Open**: Requester publishes ticket TXXM with postage\n2. **Acknowledge**: Operator publishes ack TXXM within SLA\n3. **Negotiation**: Back-and-forth TXXMs (included in base postage)\n4. **Resolution**: Operator publishes resolution TXXM\n5. **Close**: Requester confirms resolution\n6. **Dispute**: If unresolved, governance vote (additional 500 sats)\n\n## LOC Metering\n\nLines of code (LOC) are metered for all Kapnet source contributions.\n\n### LOC Pricing\n\n| Action | Rate |\n|--------|------|\n| Code review (per 100 LOC) | 50 sats |\n| Code contribution (per 100 LOC) | 100 sats |\n| Bug fix (per 100 LOC) | 200 sats |\n| Documentation (per 100 LOC) | 25 sats |\n| Test coverage (per 100 LOC) | 75 sats |\n\n### LOC TXXM\n\n```json\n{\n \"type\": \"loc-meter\",\n \"repository\": \"kapnet-source\",\n \"commit\": \"\",\n \"loc_added\": 150,\n \"loc_removed\": 30,\n \"loc_net\": 120,\n \"category\": \"feature|bugfix|docs|test\",\n \"author\": \"\",\n \"postage_paid\": 120,\n \"hedlbits_earned\": 120\n}\n```\n\n## Relay-Aware Metering\n\nWhen relays become more Kapnet-aware, they can:\n\n1. **Enforce postage**: Reject TXXMs without valid payment proof\n2. **Track Hedlbits**: Maintain per-npub Hedlbit balances\n3. **Dynamic pricing**: Adjust rates based on relay load\n4. **Priority routing**: Higher postage = faster relay propagation\n5. **Spam filtering**: Minimum postage acts as spam prevention\n\n### Relay Kapnet-Awareness Levels\n\n| Level | Capabilities |\n|-------|-------------|\n| 0 — Dumb relay | Accepts all TXXMs, no metering |\n| 1 — Postage-aware | Validates payment proof, rejects unpaid |\n| 2 — Hedlbit-aware | Tracks Hedlbit balances, enforces burns |\n| 3 — Dynamic pricing | Adjusts rates based on load |\n| 4 — Full Kapnet node | Runs kapnetd, participates in braid |\n\n## Incoming Hedlbit Negotiations\n\nWhen traffic is hard and relays become more Kapnet-aware:\n\n### Negotiation Protocol\n\n1. **Request**: Node A sends Hedlbit-negotiation TXXM to Node B\n2. **Counter**: Node B responds with counter-offer\n3. **Agreement**: Both nodes publish agreement TXXM\n4. **Execution**: Hedlbits transferred, services rendered\n\n### Negotiation TXXM\n\n```json\n{\n \"type\": \"hedlbit-negotiation\",\n \"version\": \"1.0\",\n \"from\": \"\",\n \"to\": \"\",\n \"proposal\": {\n \"service\": \"relay-priority|blob-storage|validation|research\",\n \"hedlbits_offered\": 1000,\n \"duration\": \"30 days\",\n \"terms\": \"Description of service level\"\n },\n \"status\": \"proposed|accepted|rejected|expired\",\n \"created\": \"\"\n}\n```\n\n### Dynamic Hedlbit Pricing\n\nWhen network load increases:\n- Base Hedlbit rates increase proportionally\n- Nodes can negotiate bulk discounts\n- Long-term contracts get better rates\n- Emergency services cost 5x normal rate\n\n## Implementation\n\n### Phase 1: Postage Enforcement (Now)\n- Define postage rates for all TXXM types\n- Publish rate card to wiki\n- Begin tracking Hedlbit balances\n\n### Phase 2: Vending Machines (Week 2)\n- Create first vending machine (wiki content)\n- Implement purchase flow\n- Test delivery mechanism\n\n### Phase 3: Support Tickets (Week 3)\n- Create support KOR\n- Implement ticket lifecycle\n- Set up SLA tracking\n\n### Phase 4: LOC Metering (Week 4)\n- Integrate with git commits\n- Track LOC contributions\n- Pay contributors in Hedlbits\n\n### Phase 5: Relay Negotiation (Ongoing)\n- Negotiate with relay operators\n- Implement dynamic pricing\n- Establish Hedlbit exchange\n","created_at",1781132546,"id","4531c9f1ccf21e7272aabb1a3b5841d2cd46ea77ca5330c8786f1039bdd975dc","kind",30023,"pubkey","6b839e113c9315e9c3f106fb182c18b25dc871f48cf1d86fa3e3d90268ad2b1a","sig","f25c7a4ad916428afa19da9b916616445bd890631cd1621eaa81f5f6e11b5038e3bea7912f60b9b26f295197f3a010d1856756a06a3d756c9d5e1e4035637c12","tags",[28,29,30,31,32,33,34,35],[46,47],[44,45],[42,43],[40,41],[36,39],[36,38],[36,12],[36,37],"t","economic","metering","kapnet","summary","Postage rates, Hedlbit accounting, vending machines, support tickets, LOC metering, relay-aware pricing","published_at","1781132546","title","Kapnet Metering & Vending Protocol — Charge for Everything","d","metering-vending-protocol-v010"]