@jonathanbulkeley/plugin-mycelia-signal

Mycelia Signal sovereign price oracle plugin for ElizaOS.

56 endpoints covering crypto pairs, FX rates, economic indicators, and commodities. Every response is cryptographically signed and independently verifiable. No API keys. No accounts. Pay per query via Lightning (L402) or USDC on Base (x402).

What is Mycelia Signal?

Mycelia Signal is a sovereign oracle — a price and data attestation service that signs every response with a cryptographic key. Agents and applications can verify that data came from Mycelia Signal and has not been tampered with, without trusting any intermediary.

• L402 (Lightning): Pay in sats. secp256k1 ECDSA signatures. Bitcoin-native.
• x402 (USDC on Base): Pay in USDC. Ed25519 signatures. EVM-native.
• 56 endpoints: Crypto, FX, economic indicators, commodities.
• Preview mode: Append /preview to any endpoint for free unsigned sample data.

Docs: myceliasignal.com/docs

Endpoints

Crypto Pairs (18 pairs including VWAP)

BTC/USD, BTC/EUR, BTC/JPY (spot + VWAP), ETH/USD, ETH/EUR, ETH/JPY, SOL/USD, SOL/EUR, SOL/JPY, XRP/USD, ADA/USD, DOGE/USD

Precious Metals (3 pairs)

XAU/USD, XAU/EUR, XAU/JPY

FX Rates (16 pairs)

EUR/USD, EUR/JPY, EUR/GBP, EUR/CHF, EUR/CNY, EUR/CAD, GBP/USD, GBP/JPY, GBP/CHF, GBP/CNY, GBP/CAD, USD/JPY, USD/CHF, USD/CNY, USD/CAD, CHF/JPY, CHF/CAD, CNY/JPY, CNY/CAD, CAD/JPY

US Economic Indicators (8 indicators)

CPI, CPI Core, Unemployment Rate, Nonfarm Payrolls, Fed Funds Rate, GDP, PCE, Yield Curve

EU Economic Indicators (6 indicators)

HICP, HICP Core, HICP Services, Unemployment Rate, GDP, Employment

Commodities (5 indicators)

WTI Crude, Brent Crude, Natural Gas, Copper, US Dollar Index (DXY)

Pricing

| Category | x402 (USDC) | L402 (sats) | |----------|-------------|-------------| | Price pairs & FX | $0.01 | 10 sats | | VWAP pairs | $0.02 | 20 sats | | Economic indicators | $0.10 | 1000 sats | | Commodities | $0.10 | 1000 sats |

Installation

npm install @jonathanbulkeley/plugin-mycelia-signal

Usage

Free mode (preview data — no payment required)

The plugin works out of the box with no configuration. Agents can query any supported pair using natural language. Without a payment handler configured, the plugin fetches free unsigned preview data (up to 5 minutes stale).

import { myceliaSignalPlugin } from '@jonathanbulkeley/plugin-mycelia-signal';

const agent = new AgentRuntime({
  plugins: [myceliaSignalPlugin],
  // ... other config
});

Paid mode — L402 (Lightning)

Configure a Lightning payment handler to receive signed attestations:

import { createMyceliaSignalPlugin } from '@jonathanbulkeley/plugin-mycelia-signal';

const plugin = createMyceliaSignalPlugin({
  lightningPreimageFetcher: async (invoice: string) => {
    // Pay the invoice with your Lightning node/wallet and return the preimage
    const preimage = await yourLightningNode.payInvoice(invoice);
    return preimage;
  },
});

Paid mode — x402 (USDC on Base)

import { createMyceliaSignalPlugin } from '@jonathanbulkeley/plugin-mycelia-signal';

const plugin = createMyceliaSignalPlugin({
  x402PaymentHandler: async (paymentDetails: unknown) => {
    // Sign and submit the USDC transfer on Base, return the X-Payment header value
    const header = await yourWallet.signX402Payment(paymentDetails);
    return header;
  },
});

Example Queries

Agents respond to natural language. Examples:

• "What's the Bitcoin price?"
• "Get me the BTC/USD VWAP"
• "What's the current EUR/USD rate?"
• "What's the gold price in USD?"
• "What's US CPI?"
• "Get the Fed Funds Rate"
• "What's the WTI crude oil price?"
• "What's the DXY?"

Response Format

Every paid response includes a signed canonical attestation:

{
  "domain": "BTCUSD",
  "canonical": "v1|PRICE|BTCUSD|84231.50|USD|2|binance,bitstamp,coinbase,kraken,...|median|1741514400|482910",
  "signature": "<base64-encoded-signature>",
  "pubkey": "<public-key-hex>",
  "signing_scheme": "secp256k1_ecdsa"
}

The canonical string is the signed payload. Verify it independently using the public key at myceliasignal.com/docs/keys.

Canonical Format

v1|PRICE|PAIR|PRICE|CURRENCY|DECIMALS|SOURCES|METHOD|TIMESTAMP|NONCE

See Canonical Format docs for full specification.

Signature Verification

L402 (secp256k1 ECDSA) — Python

import hashlib, base64
from coincurve import PublicKey

def verify_l402(response: dict) -> bool:
    msg_hash = hashlib.sha256(response["canonical"].encode()).digest()
    pubkey = PublicKey(bytes.fromhex(response["pubkey"]))
    return pubkey.verify(base64.b64decode(response["signature"]), msg_hash, hasher=None)

x402 (Ed25519) — Python

import hashlib, base64
from nacl.signing import VerifyKey
from nacl.encoding import RawEncoder

def verify_x402(response: dict) -> bool:
    msg_hash = hashlib.sha256(response["canonical"].encode()).digest()
    vk = VerifyKey(bytes.fromhex(response["pubkey"]), encoder=RawEncoder)
    try:
        vk.verify(msg_hash, base64.b64decode(response["signature"]))
        return True
    except Exception:
        return False

Full verification guide: myceliasignal.com/docs/verification

Public Keys

Each GC node uses its own per-instance keypair:

| Node | Protocol | Public Key | |------|----------|------------| | US GC | L402 (secp256k1) | 03c1955b8c543494c4ecd86d167105bcc7ca9a91b8e06cb9d6601f2f55a89abfbf | | Asia GC | L402 (secp256k1) | 02b1377c30c7dcfcba428cf299c18782856a12eb4fab32b87081460f4ba2deab73 | | US GC | x402 (Ed25519) | f4f0e52b5f7b54831f965632bf1ebf72769beda4c4e3d36a593f7729ec812615 | | Asia GC | x402 (Ed25519) | 7ab07fbe7d08cd16823e5eb0db0e21f3f38e9366d5fd00d14e95df0fb9b51a1a |

Full public keys page: myceliasignal.com/docs/keys

Links

• Website: myceliasignal.com
• Docs: myceliasignal.com/docs
• npm: npmjs.com/package/@jonathanbulkeley/plugin-mycelia-signal
• GitHub: github.com/jonathanbulkeley/elizaos-plugin-mycelia-signal
• API: api.myceliasignal.com

License

MIT