The @taas/sdk library is the primary interface for interacting with the TaaS Programmable Oracle Gateway. It provides a chainable Fluent API for accessing attested real-world data across crypto, sports, weather, economics, and finance, all backed by the decentralized TaaS node network.

This client eliminates the need for maintaining node infrastructure, managing private keys, or managing individual data provider subscriptions.

---

Installation

pnpm add @taas/taas-sdk

---

Quick Start

The SDK features a Fluent API for building verifiable data intents:

import { TaaS } from '@taas/sdk';

// Build a verifiable intent for a sports match
const intent = await TaaS.intent('liverpool-victory')
    .sports('football').score({ homeTeam: 'Liverpool', awayTeam: 'Arsenal' })
    .check('home_score > away_score')
    .attest();

console.log(intent.result);      // True/False verdict
console.log(intent.attestation); // Cryptographic proof

---

Authentication

Requests to the gateway require a valid JWT issued from the TaaS Dashboard.

1. Log in to the TaaS Dashboard.
2. Navigate to Settings and select API Keys.
3. Generate and secure a new authorization token.

Initialize the client with the retrieved token:

const gateway = new TruthGatewayClient({
    jwtToken: process.env.TAAS_API_KEY
});

API keys are scoped to a specific wallet address. Every request is signed by the gateway and remains verifiable against the protocol contracts.

---

Domain Methods

Finance

const client = gateway.finance();

// Retrieve current spot price
const btc = await client.price('BTC');

// Retrieve historical price at a specific Unix timestamp
const historical = await client.priceAt('ETH', 1700000000000);

// Retrieve the exchange rate between fiat currencies
const rate = await client.forex('USD', 'EUR');

---

Domain Reference

Domain	Method	Resolution
finance()	price(symbol)	Spot price in USD via multi-source consensus.
crypto()	price(symbol)	Digital asset valuation with outlier rejection.
sports()	score(params)	Active match results via Global Identity Mapping.
weather()	current(lat, lon)	Real-time atmospheric conditions.
economics()	series(id)	Macroeconomic trend indices.

---

Query Execution

Developers can invoke specialized truth queries by their identifiers. Queries serve as verifiable truth definitions registered within the network.

import { TruthGatewayClient } from '@taas/taas-sdk';

const gateway = new TruthGatewayClient({ jwtToken: process.env.TAAS_API_KEY });

// Execute a registered truth query
const result = await gateway.executeQuery('btc-price-daily', {
    symbol: 'BTCUSDT'
});

console.log(result.value);        // The resolved truth value
console.log(result.attestation);  // The cryptographic proof

---

Verifying Attestations

Every response includes an attestation that should be verified against the on-chain oracle contracts for high-assurance applications.

import { verifyAttestation } from '@taas/taas-sdk';

const result = await gateway.finance().price('BTC');

// Perform on-chain verification
const isValid = await verifyAttestation(result.attestation, {
    oracleAddress: '0x383E24c68A57eCf2D728CaE2B93637c2fb608bE1',
    rpcUrl: 'https://rpc.taas.network'
});

if (!isValid) {
    throw new Error('Verification failed: attestations are invalid.');
}

---

Developer Types

import {
    TruthPoint,
    TruthAttestation,
    QueryExecutionResult,
    OutcomeType
} from '@taas/taas-sdk';

Type	Description
TruthPoint<T>	A single attested data point with provenance metadata.
TruthAttestation	The cryptographic evidence from the network.
QueryExecutionResult	The comprehensive output of a truth query.
OutcomeType	Classifies results as scalar, binary, categorical, or probabilistic.

---

Rate Limits and Quotas

Tier	Requests per Minute	Historical Access
Standard	60	30 days
Developer	600	1 year
Enterprise	Custom	Full history

---

Error Management

import { TaasApiError, TaasAttestationError } from '@taas/taas-sdk';

try {
    const result = await gateway.sports().matchDetails('match-hash');
} catch (err) {
    if (err instanceof TaasApiError) {
        console.error('Network error:', err.message);
    } else if (err instanceof TaasAttestationError) {
        console.error('Integrity error: attestation rejected.');
    }
}

---

Related Documentation

• TaaS Interfaces: Framework for custom adapters.