开发者 | Gnomon

SDK

官方 SDK

官方 SDK 封装了常用的创建、查询、验证和追溯流程，适合直接嵌入业务系统、审计平台或自动化任务。

python.py

import asyncio
from gnomon_sdk import GnomonClient

async def main():
    async with GnomonClient(
        "http://gnomonsystem.com/api",
        api_key="your-api-key",
        origin_fingerprint="<origin from /healthz>",
    ) as client:
        latest = await client.latest_event_anchor()
        event_hash = bytes.fromhex("aa" * 32)
        created = await client.create_event_anchor(
            event_hash,
            prev_anchor_id=latest.anchor_id if latest else None,
            client_event_id="evt-001",
        )
        verified = await client.verify_event_anchor(
            created.anchor.anchor_id,
            event_hash,
            verify_depth=3,
        )

pip install gnomon-sdk

typescript.ts

import { GnomonClient, fromHex } from '@gnomon/sdk';

const client = new GnomonClient({
  endpoint: 'http://gnomonsystem.com/api',
  apiKey: 'your-api-key',
  originFingerprint: '<origin from /healthz>',
});

const latest = await client.latestEventAnchor();
const hash = new Uint8Array(32).fill(0xaa);
const created = await client.createEventAnchor(hash, {
  prevAnchorId: latest ? fromHex(latest.anchorId) : null,
  clientEventId: 'evt-001',
});

npm install @gnomon/sdk

main.rs

use gnomon_sdk::GnomonClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = GnomonClient::builder()
        .endpoint("http://gnomonsystem.com/api")
        .api_key("your-api-key")
        .origin_fingerprint([0x01u8; 32])
        .build()?;

    let hash = [0xAAu8; 32];
    let created = client.create_event_anchor(hash).await?;

cargo add gnomon-sdk

公开 API

核心 API

开发者接入通常只需要以下主路径。更完整的接口可以在接口试验场中查看和测试。

方法	接口	用途
GET	/healthz	检查节点健康并读取接入所需的来源标识
POST	/v1/event-anchors	创建天璇协议事件锚
GET	/v1/event-anchors/latest	查询某个来源的最新锚点，用于连续写入
POST	/v1/event-anchors:verify	验证锚点完整性与深度
GET	/v1/event-anchors/{anchor_id}/trace	追溯链路
POST	/v1/event-anchors/batch	批量创建事件锚
POST	/v1/event-anchors:batchVerify	批量验证事件锚