client-sdk-go

module

v1.2.1 Latest Latest Go to latest Published: Oct 19, 2021 License: Apache-2.0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/diem/client-sdk-go

Links

Open Source Insights

README ¶

Note to readers: On December 1, 2020, the Diem Association was renamed to Diem Association. The project repos are in the process of being migrated. All projects will remain available for use here until the migration to a new GitHub Organization is complete.

client-sdk-go

client-sdk-go is the official Diem Client SDK for the Go programming language.

Overview of SDK's Packages

diemclient: diem JSON-RPC APIs client
jsonrpc: a JSON-RPC 2.0 SPEC client
diemkeys: keys utils, including generating public & private keys for testing, creating auth key and account address from public key.
diemsigner: sign transaction logic
txnmetadata: utils for creating peer to peer transaction metadata. (LIP-4)
diemid: encoding & decoding Diem Account Identifier and Intent URL. (LIP-5)
testnet: testnet utils
stdlib: move stdlib script utils. This is generated code, for constructing transaction script playload.
diemtypes: Diem on-chain data structure types. Mostly generated code with small extension code for attaching handy functions to generated types.
examples: examples of how to use this SDK.
- submit transaction and wait: this example shows how to submit a transaction and wait for its result; it also shows how to handle a stale response error in various cases.
- create child VASP account: this example shows how to create ChildVASP account for a ParentVASP account.
- p2p transfer: this example shows 4 different types of p2p transfers between custodial accounts and non-custodial accounts.
- intent identifier: this example shows how to use diemid for encoding and decoding the intent identifier / url.

Installing

Use go get to retrieve the SDK to add it to your GOPATH workspace, or project's Go module dependencies.

go get github.com/diem/client-sdk-go

To update the SDK use go get -u to retrieve the latest version of the SDK.

go get -u github.com/diem/client-sdk-go

Development

Run test

make test

Generate diemtypes & move stdlib script encoder & decoder

git submodule update
make gen

Upgrade diemtypes and move stdlib

git submodule update
cd diem
git pull origin master
cd ..
make gen

API Documentation

The Go Client SDK API documentation is currently available at godoc.org.

License

Apache License V2

Contributing

CONTRIBUTING

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
diemclient Provides Diem JSON-RPC API client, see https://github.com/diem/diem/blob/master/json-rpc/json-rpc-spec.md for more details.	Provides Diem JSON-RPC API client, see https://github.com/diem/diem/blob/master/json-rpc/json-rpc-spec.md for more details.
diemclienttest Provides builders for creating JSON-RPC response result in test.	Provides builders for creating JSON-RPC response result in test.
diemid Provides utility functions for Diem Intent Identifier and Account Identifier (https://github.com/diem/lip/blob/master/lips/lip-5.md)	Provides utility functions for Diem Intent Identifier and Account Identifier (https://github.com/diem/lip/blob/master/lips/lip-5.md)
bech32 Package bech32 reference implementation for Bech32 and segwit addresses.	Package bech32 reference implementation for Bech32 and segwit addresses.
diemjsonrpctypes Provides Diem JSON-RPC API response data types.	Provides Diem JSON-RPC API response data types.
diemkeys Provides interface for abstracting private key and public key implementations, utility functions for authentication key.	Provides interface for abstracting private key and public key implementations, utility functions for authentication key.
diemsigner Provides signing transaction logic.	Provides signing transaction logic.
diemtypes Provides Diem on-chain data types, utility functions for converting types.	Provides Diem on-chain data types, utility functions for converting types.
examples
address-encoder
create-child-vasp-account
exampleutils
intent-identifier
p2p-transfers
jsonrpc Provides a general JSON-RPC client, decodes Diem extension fields.	Provides a general JSON-RPC client, decodes Diem extension fields.
jsonrpctest Provides a simple json-rpc client stub for testing client without connecting to remote server.	Provides a simple json-rpc client stub for testing client without connecting to remote server.
stdlib Provides Diem move language stdlib script encoding and decoding utilities.	Provides Diem move language stdlib script encoding and decoding utilities.
testnet Provides Diem Testnet testing utilities.	Provides Diem Testnet testing utilities.
txnmetadata Provides utility functions for creating peer to peer transaction metadata (https://github.com/diem/lip/blob/master/lips/lip-4.md).	Provides utility functions for creating peer to peer transaction metadata (https://github.com/diem/lip/blob/master/lips/lip-4.md).