> For the complete documentation index, see [llms.txt](https://docs-sdk.crypto-chief.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-sdk.crypto-chief.com/processing/go.md).

# Go SDK

The official Go client for the [Crypto Chief](https://crypto-chief.com/processing/) crypto processing API. One import gives you typed access to payments, payouts, on-chain transactions, wallets, and webhooks across 25+ chains.

[![Go Reference](https://pkg.go.dev/badge/github.com/crypto-chiefs/cryptochief-crypto-processing-go.svg)](https://pkg.go.dev/github.com/crypto-chiefs/cryptochief-crypto-processing-go)

## Requirements

* Go **1.20+**
* A Crypto Chief **Merchant ID** and **API key** (Dashboard → Project)

## Installation

```bash
go get github.com/crypto-chiefs/cryptochief-crypto-processing-go@latest
```

```go
import "github.com/crypto-chiefs/cryptochief-crypto-processing-go"
```

The package name is `cryptochief`, so you call it as `cryptochief.New(...)`.

## Quickstart

```go
c, err := cryptochief.New("MERCHANT_ID", "API_KEY")
if err != nil {
    log.Fatal(err)
}

est, err := c.Payouts.Estimate(context.Background(), &cryptochief.EstimatePayoutRequest{
    Network:   cryptochief.ChainEthSepolia,
    Coin:      "ETH",
    Amount:    "0.0001",
    ToAddress: "0xRecipient...",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println("amount to receive:", est.AmountToReceive)
```

{% hint style="success" %}
If `Estimate` returns without an error, your credentials and signing are working end-to-end.
{% endhint %}

## What you can do

| Domain                       | Service          | Key methods                                                |
| ---------------------------- | ---------------- | ---------------------------------------------------------- |
| Single & batch payouts       | `c.Payouts`      | `Estimate`, `Execute`, `BatchExecute`, `Info`, `History`   |
| Sign / execute arbitrary txs | `c.Transactions` | `Sign`, `Execute`, `SignEVMCall`, `JettonTransfer`         |
| Accept payments              | `c.PayIns`       | `Create`, `SelectAsset`, `Cancel`, `Info`, `History`       |
| Wallets + RSA decrypt        | `c.Wallets`      | `Generate`, `List`, `Freeze`, `DecryptPrivateKey`          |
| Treasury sweeps              | `c.Sweeps`       | `Force`, `History`                                         |
| On-chain queries             | `c.Blockchain`   | `ContractsAvailable`, `WalletBalance`, `TransactionStatus` |
| Fiat ↔ crypto rates          | `c.Currencies`   | `FiatToCrypto`, `CryptoToFiat`                             |

## Explore the guides

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🔑 Authentication</strong></td><td>Credentials, client setup, and request signing.</td><td><a href="/pages/ECORWaiNPePsQYBxG8Uc">/pages/ECORWaiNPePsQYBxG8Uc</a></td></tr><tr><td><strong>💸 Send a payout</strong></td><td>Estimate, execute idempotently, and confirm.</td><td><a href="/pages/lsOQgZ6xxRf8WYxz1HH5">/pages/lsOQgZ6xxRf8WYxz1HH5</a></td></tr><tr><td><strong>📥 Accept payments</strong></td><td>Create PayIn invoices and read deposits.</td><td><a href="/pages/YXg8w5b2BHxOqIDpyMUq">/pages/YXg8w5b2BHxOqIDpyMUq</a></td></tr><tr><td><strong>📡 Webhooks</strong></td><td>Verify signatures and handle typed events.</td><td><a href="/pages/YUSfSqzzuAQsB0Se4LcH">/pages/YUSfSqzzuAQsB0Se4LcH</a></td></tr><tr><td><strong>🧩 Contract calls</strong></td><td>EVM / TRON ABI calls with no hand-encoded calldata.</td><td><a href="/pages/lN1NvCOTifHv8QbxINLq">/pages/lN1NvCOTifHv8QbxINLq</a></td></tr><tr><td><strong>💎 TON transfers</strong></td><td>Jetton, NFT, and comment transfers in one call.</td><td><a href="/pages/SiKyvcQf0hp3o1lbXCoy">/pages/SiKyvcQf0hp3o1lbXCoy</a></td></tr></tbody></table>