For the complete documentation index, see llms.txt. This page is also available as Markdown.

链码概念与结构

超级账本 Fabric 中的链码(Chaincode)负责响应应用程序提交的交易请求,执行合约逻辑,并与账本状态交互。

链码执行过程中可以创建状态并写入账本。状态绑定到链码命名空间,默认仅由该链码访问;在合适的权限和业务设计下,链码也可以调用其他链码。Fabric 2.x 支持内置链码运行时,也支持外部链码服务模式。

Fabric 支持多种链码开发语言,包括 Go、JavaScript/TypeScript、Java 等。Go 新项目优先使用 Contract API。

推荐:Contract API

Contract API 用普通 Go 方法描述交易函数,框架负责参数映射、返回值序列化、错误处理和交易上下文注入。当前示例使用 v2 模块:

require github.com/hyperledger/fabric-contract-api-go/v2 v2.2.2

最小结构如下。

package main

import (
	"fmt"

	"github.com/hyperledger/fabric-contract-api-go/v2/contractapi"
)

type SmartContract struct {
	contractapi.Contract
}

func (s *SmartContract) InitLedger(ctx contractapi.TransactionContextInterface) error {
	return ctx.GetStub().PutState("hello", []byte("world"))
}

func (s *SmartContract) Read(ctx contractapi.TransactionContextInterface, key string) (string, error) {
	value, err := ctx.GetStub().GetState(key)
	if err != nil {
		return "", fmt.Errorf("failed to read %s: %w", key, err)
	}
	if value == nil {
		return "", fmt.Errorf("state %s does not exist", key)
	}
	return string(value), nil
}

func (s *SmartContract) Write(ctx contractapi.TransactionContextInterface, key string, value string) error {
	return ctx.GetStub().PutState(key, []byte(value))
}

func main() {
	chaincode, err := contractapi.NewChaincode(&SmartContract{})
	if err != nil {
		fmt.Printf("Error creating chaincode: %s", err)
		return
	}
	if err := chaincode.Start(); err != nil {
		fmt.Printf("Error starting chaincode: %s", err)
	}
}

可选:底层 shim API

需要直接控制 Fabric 响应对象时,可以使用 shim API。当前 Go v2 包路径如下:

底层接口只包含 Init 和 Invoke:

Fabric v1 早期示例中的独立 Query 回调已经不是当前链码接口的一部分。读取类交易也通过 Invoke 路径进入链码,再由函数名路由到只读逻辑;客户端侧则通常用 Gateway 的 evaluate 类调用表达“只读查询”。

最后更新于