webledgers

Map URIs to balances in JSON-LD web ledger documents with CLI validation workflows.

3|1|Updated Aug 23, 2019
One-click install
npx skills add https://github.com/solidpayorg/webledgers --skill webledgers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webledgers
Source: https://github.com/solidpayorg/webledgers/tree/main
Command: npx skills add https://github.com/solidpayorg/webledgers --skill webledgers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Webledgers provides a standardized, portable way to map any URI to a numerical balance so teams and systems can query and reconcile balances across heterogeneous platforms without building custom integrations.

Core Features & Use Cases

  • Universal Identifiers: Use URIs (https, mailto, tel, bitcoin, did:nostr, urn, etc.) as canonical keys for balances.
  • Flexible Amounts: Support for single-string default-currency amounts and multi-currency arrays for complex use cases.
  • CLI + API: Interactive CLI workflows for create/add/balance/validate/merge and a JavaScript API for programmatic ledger creation, loading, and validation.
  • Validation & Safety: Built-in validation with errors and warnings, URI normalization (urn:local: prefixing), and well-known RFC 5785 location conventions for discoverability.

Quick Start

Use the webledgers CLI to create a ledger, add an entry, and run validation on the resulting JSON-LD ledger.

Frequently Asked Questions about webledgers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map URIs to balances across different blockchain and social platforms?

Map URIs to balances across distributed ledger platforms by creating and querying JSON-LD web ledger documents. These documents use URIs like https, mailto, tel, and did:nostr as canonical keys to standardize and reconcile numerical balances.

How do I validate a JSON-LD web ledger and fix URI normalization errors?

Validate a JSON-LD web ledger using built-in CLI workflows that report specific errors and warnings. The process includes URI normalization with urn:local: prefixing to ensure canonical keys are correctly formatted and discoverable.

Can I use a single CLI tool to create, merge, and query multi-currency ledger documents?

Create, merge, and query multi-currency ledger documents using a single interactive CLI. It handles single-string default-currency amounts and multi-currency arrays, allowing you to manage complex balances without building custom integrations.

What is the best way to make ledger balances discoverable across decentralized identifiers?

Make ledger balances discoverable by storing JSON-LD web ledger documents at RFC 5785 well-known locations. This convention allows heterogeneous systems to programmatically locate and query balances mapped to decentralized identifiers.

Does webledger normalization work with custom application identifiers and social platform URIs?

Normalization works with custom application identifiers and social platform URIs by applying urn:local: prefixing. This ensures any URI format, including bitcoin addresses and custom schemes, functions as a portable canonical key for querying balances.

When do I need multi-currency array support instead of a single-string amount in a web ledger?

Use multi-currency array support instead of a single-string amount when a single URI must track balances across multiple currencies simultaneously. The default single-string format handles standard amounts for simpler use cases.