API docs by Redocly

elJeffe — Universal Event Notarization API (1.0.0)

Download OpenAPI specification:

URL: https://growdirect.io License: Proprietary

The elJeffe API provides universal event notarization via cryptographic hash inscription on the Bitcoin timechain. Every webhook-originated event is hashed, sealed, batched into Merkle trees, and inscribed as Ordinals on Bitcoin. Immutable. Ordered by block height. Replayable from any inscription point. The permanent successor to the IBM 4690 tLog. Built by elJeffe. Stored on Bitcoin. Forever. Note: This is an architecture specification. These endpoints describe the target API design and are not yet live.

gLog

The permanent transaction log. Immutable POS event records inscribed as Bitcoin Ordinals. Ordered by block height. Replayable from any inscription point. The permanent successor to the IBM 4690 tLog. Built by elJeffe. jeffe.io/glog

Query gLog entries for a merchant

Retrieve the permanent transaction log for a specific merchant. The gLog is an ordered sequence of POS events inscribed as Bitcoin Ordinals. Each entry is immutable, timestamped by block height, and replayable from any inscription point. Use this endpoint for deterministic state reconstruction of a merchant's complete transaction history.

Authorizations:
L402
query Parameters
merchant_id
required
string
Example: merchant_id=m_growdirect_lab_001

Partitioned merchant identifier. Each merchant's gLog is an independent ordered chain of inscriptions on the Bitcoin timechain.

from_block_height
integer <int64>
Example: from_block_height=884201

Bitcoin block height from which to begin deterministic state reconstruction. If omitted, returns entries from the merchant's first inscription forward. Use this for replay and rehydration — pick any block height, reconstruct state from that point.

limit
integer <= 1000
Default: 100

Maximum number of gLog entries to return per request.

Responses

Response samples

Content type
application/json
{
  • "merchant_id": "string",
  • "entries": [
    ],
  • "total": 0,
  • "replay_from": 0
}

Retrieve a single gLog entry by inscription ID

Look up a specific gLog entry by its Bitcoin Ordinal inscription ID. Returns the complete entry including event hash, block height, chain reference, and Merkle proof for independent verification. This is the permanent, immutable record of a POS event on the Bitcoin timechain.

Authorizations:
L402
path Parameters
inscription_id
required
string
Example: i39f7a2b8c...

Bitcoin Ordinal inscription ID. This is the permanent identifier for a gLog entry on the Bitcoin timechain. Once inscribed, this ID is valid forever.

Responses

Response samples

Content type
application/json
{
  • "merchant_id": "m_growdirect_lab_001",
  • "event_hash": "sha256:a3f9b2c8d1e4f6a7b3c9d2e5f8a1b4c7...",
  • "inscription_id": "i39f7a2b8c4d6e1f3a5b7c9d2e4f6a8b0...",
  • "block_height": 884201,
  • "previous_inscription_id": "i28e6b1a7d3c5f0e2b4a6c8d1e3f5a7b9...",
  • "replay_from": 880000,
  • "merkle_root": "sha256:f1e2d3c4b5a6...",
  • "merkle_proof": [
    ],
  • "timestamp": "2026-02-27T14:23:01Z"
}

Validation

Sat-gated event validation against the canonical gLog record on the Bitcoin timechain. L402 micropayment protocol. Pay sats to prove an event happened. Perpetual revenue per verification.

Validate an event against the canonical gLog record

Submit an event hash and inscription ID to verify the event against the canonical notarization record on the Bitcoin timechain. Returns cryptographic proof including block height, Merkle position, and independent verification path. Requires Lightning micropayment (L402 protocol).

Authorizations:
L402
Request Body schema: application/json
required
event_hash
required
string

SHA-256 hash of the original transaction payload (PII stripped before hashing). This is the fingerprint of the event to validate.

inscription_id
required
string

Bitcoin Ordinal inscription ID of the gLog entry to validate against.

Responses

Request samples

Content type
application/json
{
  • "event_hash": "sha256:a3f9b2c8d1e4f6a7...",
  • "inscription_id": "i39f7a2b8c..."
}

Response samples

Content type
application/json
{
  • "verified": true,
  • "block": 884201,
  • "merkle_position": 4721,
  • "inscription_id": "i39f7a2b8c...",
  • "timestamp": "2026-02-27T14:23:01Z",
  • "canonical_authority": "jeffe.io",
  • "merkle_proof": [
    ]
}