Saltar al contenido principal

SDKs oficiales

Java, Node.js/TypeScript, Python y Go — misma cobertura de API, mismos nombres de concepto de negocio, cada uno idiomático en su lenguaje.

Cada SDK expone dos capas sobre el mismo backend: Easy Mode para integración rápida (composición de llamadas comunes) y Core API para acceso granular a toda la superficie real de la API. Ningún SDK inventa comportamiento — todo es rastreable hasta la Referencia de API. Ver la Referencia de API completa →

Los cuatro SDKs también incluyen generación de wallet y firma de transacción en self-custody, simétricas entre lenguajes -- la clave privada se genera y usa localmente, nunca se envía a Ishtaran. Cómo funciona el self-custody →

Java

Disponible ahora

install
<dependency>
  <groupId>com.ishtaran</groupId>
  <artifactId>ishtaran-java</artifactId>
  <version>0.1.4</version>
</dependency>
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 y firma

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);

Instalación de desarrollo (cambios aún no publicados)

Para desarrollo local contra un cambio aún no publicado -- Maven Central es el camino principal arriba.

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

Node.js / TypeScript

Disponible ahora

install
npm install @ishtaran/sdk
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 y firma

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);

Instalación de desarrollo (cambios aún no publicados)

Para desarrollo local contra un cambio aún no publicado -- npm es el camino principal arriba.

local/dev install
npm install github:taylorjeftedasilva/ishtaran-node

Python

Disponible ahora

install
pip install ishtaran
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 y firma

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)

Instalación de desarrollo (cambios aún no publicados)

Para desarrollo local contra un cambio aún no publicado -- PyPI es el camino principal arriba.

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

Go

Disponible ahora

install
go get github.com/taylorjeftedasilva/ishtaran-go@v0.1.5
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 y firma

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)

Instalación de desarrollo (cambios aún no publicados)

@latest resuelve al código fuente actual a través del proxy estándar de módulos Go -- usa la versión etiquetada v0.1.3 de arriba para una versión estable y reproducible.

local/dev install
go get github.com/taylorjeftedasilva/ishtaran-go@latest

¿Construyendo con un agente de IA? Ishtaran tiene un servidor MCP (Model Context Protocol) oficial -- conocimiento, descubrimiento, planificación y validación para Claude, Codex, Cursor y cualquier otro cliente compatible con MCP. Nunca ejecuta operaciones financieras; los SDKs de arriba siguen haciendo eso. Cómo funciona el MCP →

install
npx -y @ishtaran/mcp