开发者文档 SDK

3行代码接入子舟链区块链存证 · Python & JavaScript

快速开始

Python

from zizhou_chain import ZizhouClient

client = ZizhouClient(base_url="https://art.z-zbc.com")
result = client.create_proof(
    file_path="artwork.jpg",
    title="洛神赋图",
    author="顾恺之"
)
# result.proof_id → "c7967ea3"
# result.tx_hash → "0x21b83c..."
# result.certificate_id → "ZZ-C7967EA3"

JavaScript

import { ZizhouClient } from 'zizhou-chain';

const client = new ZizhouClient({ baseUrl: 'https://art.z-zbc.com' });
const result = await client.createProof({
    file: fileBlob,
    title: '洛神赋图',
    author: '顾恺之'
});
// result.proofId, result.txHash, result.certificateId

API 概览

核心特性

• 🔗 区块链存证：文件哈希上链，不可篡改
• 📜 证书生成：自动生成链上证书编号 ZZ-XXXXXXXX
• 🔍 真伪验证：通过TX Hash验证存证真实性
• 🔐 双哈希：SHA-256 + SM3国密哈希
• 🏛️ QBFT共识：5验证者+3观察者，3秒出块

架构概览

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Python SDK   │     │   JS SDK     │     │  REST API    │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       └────────────────────┼────────────────────┘
                            │
                   ┌────────▼────────┐
                   │  Nginx (HTTPS)  │
                   └────────┬────────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
        ┌─────▼─────┐ ┌────▼────┐ ┌─────▼─────┐
        │ Flask API  │ │ Flask   │ │ Flask     │
        │ :8001 存证 │ │ :8002   │ │ :8003 积分│
        └─────┬─────┘ └────┬────┘ └─────┬─────┘
              │             │             │
              └──────┬──────┘─────────────┘
                     │
              ┌──────▼──────┐
              │ PostgreSQL  │
              └──────┬──────┘
                     │
              ┌──────▼──────┐
              │ Besu QBFT   │
              │ 8 Nodes     │
              └─────────────┘

链接

• 完整API文档
• 区块链浏览器
• Gitee 源码仓库
• 关于子舟链