Skip to content

Commit adaff43

Browse files
committed
add sdk README
1 parent ddabf6a commit adaff43

File tree

1 file changed

+32
-1
lines changed

1 file changed

+32
-1
lines changed

README.md

+32-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,32 @@
1-
# avail-go
1+
# avail-go-sdk
2+
3+
An sdk to use avail network using Golang. This is wrapper around centrigue's [go-substrate-rpc-client](https://github.com/centrifuge/go-substrate-rpc-client/tree/master)
4+
5+
## prerequisites
6+
7+
[Install](https://go.dev/doc/install) go globally if you haven't already
8+
9+
## Structure
10+
11+
This SDK is split into two main parts:
12+
13+
1. **GSRPC Wrapper**: This allows you to use all the Polkadot JS functions and types to interact with the chain. For more information and documentation, please refer to the [GSRPC Documentation](https://pkg.go.dev/github.com/centrifuge/go-substrate-rpc-client/v4#section-readme).
14+
2. **Opinionated SDK**: A simpler, more streamlined way to interact with the chain. It offers less customization but provides an easier interface. This SDK will be continuously improved to include everything needed for seamless chain interaction.
15+
16+
### Folder Structure
17+
18+
- **[`src/config`](./src/config/)**: Contains the loader to read the config file when connecting to chain
19+
- **[`src/extrinsic`](./src/extrinsic/)**: Wrapper around GSRPC so that extrinsic can be signed with avail specific AppID extension
20+
- **[src/header`](./src/header/)**: Includes the custom header for avail with added extension field and its custom enum decoding
21+
- **[`src/rpc`](./src/rpc/)**: Wraper around GSRPC block specific rpc calls inorder to accustom the custom header field for avail. Also contains the structures for kate related calls.
22+
- **[`src/sdk`](./src/sdk/)**: Contains all interfaces related to the SDK, representing the opinionated part of Avail-go-sdk.
23+
- **[`src/sdk/call`](./src/sdk/call/)**: Contains the kate related RPC calls
24+
- **[`src/sdk/tx`](./src/sdk/tx/)**: Includes the interfaces related to sdk
25+
26+
27+
## Examples
28+
the [examples](./examples/) folder and the [readme](./examples/README.md) contains examples and documentation on using the avail-go-sdk
29+
30+
## Error Reporting
31+
32+
In case you encounter a bug, don't hesitate to [open an issue](https://github.com/availproject/avail-go-sdk/issues) with the maximum amount of detail and we will deal with it as soon as possible.

0 commit comments

Comments
 (0)