SDKs oficiais | Ishtaran

Cada SDK expõe duas camadas sobre o mesmo backend: Easy Mode para integração rápida (composição de chamadas comuns) e Core API para acesso granular a toda a superfície real da API. Nenhum SDK inventa comportamento — tudo é rastreável até a Referência de API. Ver a Referência de API completa →

As quatro SDKs também trazem geração de wallet e assinatura de transação em self-custody, simétricas entre as linguagens -- a chave privada é gerada e usada localmente, nunca enviada à Ishtaran. Como o self-custody funciona →

Java

Disponível agora

install

<dependency>
  <groupId>com.ishtaran</groupId>
  <artifactId>ishtaran-java</artifactId>
  <version>0.1.4</version>
</dependency>

Ver repositório público no GitHubVer um exemplo executável

quickstart

var client = IshtaranClient.builder()
        .apiKey(System.getenv("ISHTARAN_API_KEY"))
        .environment(Environment.SANDBOX)
        .build();

var balance = client.getBalance(accountId, assetNetworkId);
System.out.println("Available: " + balance.available());

Self-custody: wallet e assinatura

self-custody

// Wallet generated locally -- the private key never leaves this process.
var generated = WalletFactory.generate();

var registered = client.wallets().register(applicationId, networkId,
        DerivationScheme.TRON_BIP44_HARDENED_ACCOUNT,
        generated.wallet().accountExtendedPublicKey(), idempotencyKey);

// Signing also happens locally, against a hash Ishtaran computed and verifies.
var signature = generated.signer().sign(0, canonicalHash);

Instalação de desenvolvimento (mudanças ainda não publicadas)

Para desenvolvimento local contra uma mudança ainda não publicada -- o Maven Central é o caminho principal acima.

local/dev install

git clone https://github.com/taylorjeftedasilva/ishtaran-java.git
cd ishtaran-java && mvn install

Node.js / TypeScript

Disponível agora

install

npm install @ishtaran/sdk

Ver repositório público no GitHubVer um exemplo executável

quickstart

import { IshtaranClient, Environment } from '@ishtaran/sdk';

const client = IshtaranClient.create({
  apiKey: process.env.ISHTARAN_API_KEY,
  environment: Environment.Sandbox,
});

const balance = await client.getBalance(accountId, assetNetworkId);
console.log('Available:', balance.available);

Self-custody: wallet e assinatura

self-custody

import { wallet, DerivationScheme } from '@ishtaran/sdk';

// Wallet generated locally -- the private key never leaves this process.
const generated = wallet.generate();

const registered = await client.wallets.register(
  applicationId, networkId, DerivationScheme.TRON_BIP44_HARDENED_ACCOUNT,
  generated.wallet.accountExtendedPublicKey, idempotencyKey,
);

// Signing also happens locally, against a hash Ishtaran computed and verifies.
const signature = generated.signer.sign(0, canonicalHash);

Instalação de desenvolvimento (mudanças ainda não publicadas)

Para desenvolvimento local contra uma mudança ainda não publicada -- o npm é o caminho principal acima.

local/dev install

npm install github:taylorjeftedasilva/ishtaran-node

Python

Disponível agora

install

pip install ishtaran

Ver repositório público no GitHubVer um exemplo executável

quickstart

from ishtaran import IshtaranClient, Environment

client = IshtaranClient.create(
    api_key=os.environ["ISHTARAN_API_KEY"],
    environment=Environment.SANDBOX,
)

balance = client.get_balance(account_id, asset_network_id)
print("Available:", balance.available)

Self-custody: wallet e assinatura

self-custody

from ishtaran.wallet import generate
from ishtaran.model.enums import DerivationScheme

# Wallet generated locally -- the private key never leaves this process.
generated = generate()

registered = client.wallets.register(
    application_id, network_id, DerivationScheme.TRON_BIP44_HARDENED_ACCOUNT,
    generated.wallet.account_extended_public_key, idempotency_key,
)

# Signing also happens locally, against a hash Ishtaran computed and verifies.
signature = generated.signer.sign(0, canonical_hash)

Instalação de desenvolvimento (mudanças ainda não publicadas)

Para desenvolvimento local contra uma mudança ainda não publicada -- o PyPI é o caminho principal acima.

local/dev install

pip install git+https://github.com/taylorjeftedasilva/ishtaran-python.git

Go

Disponível agora

install

go get github.com/taylorjeftedasilva/ishtaran-go@v0.1.5

Ver repositório público no GitHubVer um exemplo executável

quickstart

client, err := ishtaran.NewClient(
	ishtaran.WithAPIKey(os.Getenv("ISHTARAN_API_KEY")),
	ishtaran.WithEnvironment(ishtaran.Sandbox),
)

balance, err := client.GetBalance(ctx, accountID, assetNetworkID)
fmt.Println("Available:", balance.Available)

Self-custody: wallet e assinatura

self-custody

// Wallet generated locally -- the private key never leaves this process.
generated, err := ishtaran.GenerateWallet()

registered, err := client.Wallets.Register(ctx, applicationID, networkID,
	ishtaran.DerivationSchemeTronBIP44HardenedAccount,
	generated.Wallet.AccountExtendedPublicKey)

// Signing also happens locally, against a hash Ishtaran computed and verifies.
signature, err := generated.Signer.Sign(0, canonicalHash)

Instalação de desenvolvimento (mudanças ainda não publicadas)

@latest resolve para o código-fonte atual através do proxy padrão de módulos Go -- use a versão marcada v0.1.3 acima para uma versão estável e reprodutível.

local/dev install

go get github.com/taylorjeftedasilva/ishtaran-go@latest

Construindo com um agente de IA? A Ishtaran tem um servidor MCP (Model Context Protocol) oficial -- conhecimento, descoberta, planejamento e validação para Claude, Codex, Cursor e qualquer outro cliente compatível com MCP. Ele nunca executa operações financeiras; os SDKs acima continuam fazendo isso. Como o MCP funciona →

install

npx -y @ishtaran/mcp