This is the the official Go implementation of IoTeX SDK! Please refer to IoTeX whitepaper and the protocol for details.
| Components | Version | Description |
|---|---|---|
| Golang | ≥ 1.11.5 | Go programming language |
// go mod
go get github.com/iotexproject/iotex-antenna-go/v2
The below example code shows the 4 easy steps to send a transaction to IoTeX blockchain
- connect to the chain's RPC endpoint
- create an account by importing a private key
- create a client and generate an action sender
- send the transaction to the chain
package main
import (
"context"
"fmt"
"log"
"github.com/iotexproject/iotex-address/address"
"github.com/iotexproject/iotex-antenna-go/v2/account"
"github.com/iotexproject/iotex-antenna-go/v2/iotex"
"github.com/iotexproject/iotex-proto/golang/iotexapi"
)
const (
mainnetRPC = "api.iotex.one:443"
testnetRPC = "api.testnet.iotex.one:443"
mainnetChainID = 1
testnetChainID = 2
)
func main() {
// Create grpc connection
conn, err := iotex.NewDefaultGRPCConn(testnetRPC)
if err != nil {
log.Fatal(err)
}
defer conn.Close()
// Add account by private key
acc, err := account.HexStringToAccount("...")
if err != nil {
log.Fatal(err)
}
// create client
c := iotex.NewAuthedClient(iotexapi.NewAPIServiceClient(conn), testnetChainID, acc)
// send the transfer to chain
to, err := address.FromString("io1zq5g9c5c3hqw9559ks4anptkpumxgsjfn2e4ke")
if err != nil {
log.Fatal(err)
}
hash, err := c.Transfer(to, big.NewInt(10)).SetGasPrice(big.NewInt(100000000000)).SetGasLimit(20000).Call(context.Background())
if err != nil {
log.Fatal(err)
}
fmt.Println("transaction hash = %x\n", hash)
}
There are three examples demostrating the use of this SDK on Testnet. You can make examples to build and try:
./examples/chaininfoshows how to use the SDK to pull chain, block, action and delegates info./examples/openoracleshows how to deploy and invoke Open Oracle Contracts./examples/xrc20tokensshows how to deploy and invoke XRC20 tokens
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent