core

Documentation

Overview

Package core 定义了智能合约与VM系统交互所需的核心接口 合约开发者只需了解并使用此文件中的接口即可编写智能合约

Index

• Variables
• func Assert(condition any)
• func Error(msg string) error
• type Address
  • func AddressFromString(str string) Address
  • func (addr Address) String() string
• type Context
• type Hash
  • func GetHash(data []byte) Hash
  • func HashFromString(str string) Hash
  • func (h Hash) String() string
• type Object
• type ObjectID
  • func IDFromString(str string) ObjectID
  • func (id ObjectID) String() string

Variables

var ZeroAddress = Address{}

var ZeroHash = Hash{}

var ZeroObjectID = ObjectID{}

Functions

func Assert

func Assert(condition any)

func Error

func Error(msg string) error

Types

type Address

type Address [20]byte

Address 表示区块链上的地址

func AddressFromString

func AddressFromString(str string) Address

func (Address) String

func (addr Address) String() string

type Context

type Context interface {
	// 区块链信息相关
	BlockHeight() uint64      // 获取当前区块高度
	BlockTime() int64         // 获取当前区块时间戳
	ContractAddress() Address // 获取当前合约地址

	// 账户操作相关
	Sender() Address                          // 获取交易发送者或调用合约
	Balance(addr Address) uint64              // 获取账户余额
	Transfer(to Address, amount uint64) error // 转账操作

	// 对象存储相关 - 基础状态操作使用panic而非返回error
	CreateObject() Object                             // 创建新对象，失败时panic
	GetObject(id ObjectID) (Object, error)            // 获取指定对象，可能返回error
	GetObjectWithOwner(owner Address) (Object, error) // 按所有者获取对象，可能返回error
	DeleteObject(id ObjectID)                         // 删除对象，失败时panic

	// 跨合约调用
	Call(contract Address, function string, args ...any) ([]byte, error)

	// 日志与事件
	Log(eventName string, keyValues ...interface{}) // 记录事件
}

Context 是合约与区块链环境交互的主要接口

type Hash

type Hash [32]byte

func GetHash

func GetHash(data []byte) Hash

func HashFromString

func HashFromString(str string) Hash

func (Hash) String

func (h Hash) String() string

type Object

type Object interface {
	ID() ObjectID          // 获取对象ID
	Owner() Address        // 获取对象所有者
	Contract() Address     // 获取对象所属合约
	SetOwner(addr Address) // 设置对象所有者，失败时panic

	// 字段操作
	Get(field string, value any) error // 获取字段值
	Set(field string, value any) error // 设置字段值
}

Object 接口用于管理区块链状态对象

type ObjectID

type ObjectID [32]byte

ObjectID 表示状态对象的唯一标识符

func IDFromString

func IDFromString(str string) ObjectID

func (ObjectID) String

func (id ObjectID) String() string