Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

api

package

Go to main page

Versions in this module

v3

v3.0.4

Apr 24, 2026

v3.0.4-rc.1

Apr 24, 2026

v3.0.4-rc.0

Apr 24, 2026

v3.0.3

Feb 11, 2026

Changes in this version

+ func SyncPinnedCodes(cache Cache, checksums []byte) error

v3.0.3-rc.0

Feb 10, 2026

v3.0.2

Aug 26, 2025

v3.0.1

Aug 26, 2025

v3.0.0

Jun 23, 2025

Changes in this version

+ const CanonicalLength

+ const CostCanonical

+ const CostHuman

+ const DEFAULT_QUERIER_GAS_LIMIT

+ const GetPrice

+ const MOCK_CONTRACT_ADDR

+ const RangePrice

+ const RemovePrice

+ const SetPrice

+ func AnalyzeCode(cache Cache, checksum []byte) (*types.AnalysisReport, error)

+ func DefaultQuerier(contractAddr string, coins types.Array[types.Coin]) types.Querier

+ func Execute(cache Cache, checksum []byte, env []byte, info []byte, msg []byte, ...) ([]byte, types.GasReport, error)

+ func GetCode(cache Cache, checksum []byte) ([]byte, error)

+ func GetMetrics(cache Cache) (*types.Metrics, error)

+ func GetPinnedMetrics(cache Cache) (*types.PinnedMetrics, error)

+ func IBC2PacketAck(cache Cache, checksum []byte, env []byte, payload []byte, ...) ([]byte, types.GasReport, error)

+ func IBC2PacketReceive(cache Cache, checksum []byte, env []byte, payload []byte, ...) ([]byte, types.GasReport, error)

+ func IBC2PacketSend(cache Cache, checksum []byte, env []byte, payload []byte, ...) ([]byte, types.GasReport, error)

+ func IBC2PacketTimeout(cache Cache, checksum []byte, env []byte, payload []byte, ...) ([]byte, types.GasReport, error)

+ func IBCChannelClose(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func IBCChannelConnect(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func IBCChannelOpen(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func IBCDestinationCallback(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func IBCPacketAck(cache Cache, checksum []byte, env []byte, ack []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func IBCPacketReceive(cache Cache, checksum []byte, env []byte, packet []byte, ...) ([]byte, types.GasReport, error)

+ func IBCPacketTimeout(cache Cache, checksum []byte, env []byte, packet []byte, ...) ([]byte, types.GasReport, error)

+ func IBCSourceCallback(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func Instantiate(cache Cache, checksum []byte, env []byte, info []byte, msg []byte, ...) ([]byte, types.GasReport, error)

+ func LibwasmvmVersion() (string, error)

+ func Migrate(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func MigrateWithInfo(cache Cache, checksum []byte, env []byte, msg []byte, migrateInfo []byte, ...) ([]byte, types.GasReport, error)

+ func MockCanonicalizeAddress(human string) ([]byte, uint64, error)

+ func MockEnv() types.Env

+ func MockEnvBin(tb testing.TB) []byte

+ func MockFailureCanonicalizeAddress(human string) ([]byte, uint64, error)

+ func MockFailureHumanizeAddress(canon []byte) (string, uint64, error)

+ func MockFailureValidateAddress(human string) (uint64, error)

+ func MockHumanizeAddress(canon []byte) (string, uint64, error)

+ func MockIBCChannel(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannel

+ func MockIBCChannelCloseConfirm(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelCloseMsg

+ func MockIBCChannelCloseInit(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelCloseMsg

+ func MockIBCChannelConnectAck(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelConnectMsg

+ func MockIBCChannelConnectConfirm(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelConnectMsg

+ func MockIBCChannelOpenInit(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelOpenMsg

+ func MockIBCChannelOpenTry(channelID string, ordering types.IBCOrder, ibcVersion string) types.IBCChannelOpenMsg

+ func MockIBCPacket(myChannel string, data []byte) types.IBCPacket

+ func MockIBCPacketAck(myChannel string, data []byte, ack types.IBCAcknowledgement) types.IBCPacketAckMsg

+ func MockIBCPacketReceive(myChannel string, data []byte) types.IBCPacketReceiveMsg

+ func MockIBCPacketTimeout(myChannel string, data []byte) types.IBCPacketTimeoutMsg

+ func MockInfo(sender types.HumanAddress, funds []types.Coin) types.MessageInfo

+ func MockInfoBin(tb testing.TB, sender types.HumanAddress) []byte

+ func MockInfoWithFunds(sender types.HumanAddress) types.MessageInfo

+ func MockValidateAddress(input string) (gasCost uint64, _ error)

+ func NewMockAPI() *types.GoAPI

+ func NewMockFailureAPI() *types.GoAPI

+ func Pin(cache Cache, checksum []byte) error

+ func Query(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func ReleaseCache(cache Cache)

+ func RemoveCode(cache Cache, checksum []byte) error

+ func Reply(cache Cache, checksum []byte, env []byte, reply []byte, ...) ([]byte, types.GasReport, error)

+ func StoreCode(cache Cache, wasm []byte, persist bool) ([]byte, error)

+ func StoreCodeUnchecked(cache Cache, wasm []byte) ([]byte, error)

+ func Sudo(cache Cache, checksum []byte, env []byte, msg []byte, gasMeter *types.GasMeter, ...) ([]byte, types.GasReport, error)

+ func TestBankQuerierAllBalances(t *testing.T)

+ func TestBankQuerierBalance(t *testing.T)

+ func TestMockApi(t *testing.T)

+ func TestReflectCustomQuerier(t *testing.T)

+ func Unpin(cache Cache, checksum []byte) error

+ type BankQuerier struct

+ Balances map[string]types.Array[types.Coin]

+ func NewBankQuerier(balances map[string]types.Array[types.Coin]) BankQuerier

+ func (q BankQuerier) Query(request *types.BankQuery) ([]byte, error)

+ type Cache struct

+ func InitCache(config types.VMConfig) (Cache, error)

+ type CapitalizedQuery struct

+ Text string

+ type CustomQuerier interface

+ Query func(request json.RawMessage) ([]byte, error)

+ type CustomQuery struct

+ Capitalized *CapitalizedQuery

+ Ping *struct{}

+ type CustomResponse struct

+ Msg string

+ type DBState struct

+ CallID uint64

+ Store types.KVStore

+ type ErrorGasOverflow struct

+ Descriptor string

+ type ErrorOutOfGas struct

+ Descriptor string

+ type Lookup struct

+ func NewLookup(meter MockGasMeter) *Lookup

+ func (l *Lookup) SetGasMeter(meter MockGasMeter)

+ func (l *Lookup) WithGasMeter(meter MockGasMeter) *Lookup

+ func (l Lookup) Delete(key []byte)

+ func (l Lookup) Get(key []byte) []byte

+ func (l Lookup) Iterator(start, end []byte) types.Iterator

+ func (l Lookup) ReverseIterator(start, end []byte) types.Iterator

+ func (l Lookup) Set(key, value []byte)

+ type MockGasMeter interface

+ ConsumeGas func(amount types.Gas, descriptor string)

+ func NewMockGasMeter(limit types.Gas) MockGasMeter

+ type MockQuerier struct

+ Bank BankQuerier

+ Custom CustomQuerier

+ func (q *MockQuerier) Query(request types.QueryRequest, _gasLimit uint64) ([]byte, error)

+ func (q MockQuerier) GasConsumed() uint64

+ type NoCustom struct

+ func (q NoCustom) Query(request json.RawMessage) ([]byte, error)

+ type Querier = types.Querier

+ type ReflectCustom struct

+ func (q ReflectCustom) Query(request json.RawMessage) ([]byte, error)

v3.0.0-rc.0

Jun 20, 2025

v3.0.0-ibc2.1

May 15, 2025

v3.0.0-ibc2.0

Apr 29, 2025

Other modules containing this package

github.com/CosmWasm/wasmvm

github.com/CosmWasm/wasmvm/v2