@andrewkimjoseph/celina-sdk 0.2.12 → 0.4.0

package/build/config/carbon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon.js","sourceRoot":"","sources":["../../src/config/carbon.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,4BAA4B,GAAG,4BAA4B,CAAC;AAEzE,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,uBAAuB,EAAE,4CAA4C;IACrE,cAAc,EAAE,4CAA4C;IAC5D,kCAAkC;IAClC,gBAAgB,EAAE,4CAA4C;IAC9D,oBAAoB,EAAE,4CAA4C;CAC1D,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC"}

package/build/config/gooddollar.d.ts

@@ -1,2 +1,4 @@
 /** GoodDollar IdentityV4 contract on Celo mainnet. */
 export declare const GOODDOLLAR_IDENTITY_ADDRESS: "0xC361A6E67822a0EDc17D899227dd9FC50BD62F42";
+/** GoodDollar UBISchemeV2 contract on Celo mainnet. */
+export declare const GOODDOLLAR_UBI_SCHEME_ADDRESS: "0x43d72Ff17701B2DA814620735C39C620Ce0ea4A1";

package/build/config/gooddollar.js

@@ -1,3 +1,5 @@
 /** GoodDollar IdentityV4 contract on Celo mainnet. */
 export const GOODDOLLAR_IDENTITY_ADDRESS = "0xC361A6E67822a0EDc17D899227dd9FC50BD62F42";
+/** GoodDollar UBISchemeV2 contract on Celo mainnet. */
+export const GOODDOLLAR_UBI_SCHEME_ADDRESS = "0x43d72Ff17701B2DA814620735C39C620Ce0ea4A1";
 //# sourceMappingURL=gooddollar.js.map

package/build/config/gooddollar.js.map

@@ -1 +1 @@
-{"version":3,"file":"gooddollar.js","sourceRoot":"","sources":["../../src/config/gooddollar.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GACtC,4CAAqD,CAAC"}
+{"version":3,"file":"gooddollar.js","sourceRoot":"","sources":["../../src/config/gooddollar.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GACtC,4CAAqD,CAAC;AAExD,uDAAuD;AACvD,MAAM,CAAC,MAAM,6BAA6B,GACxC,4CAAqD,CAAC"}

package/build/config/sdk-config.d.ts

@@ -4,6 +4,20 @@ export interface SdkConfig {
     rpcUrl: string;
     /** Ethereum mainnet RPC for ENS resolution (optional). */
     ethRpcUrl?: string;
+    /** Carbon DeFi REST API base URL (default https://mcp.carbondefi.xyz). */
+    carbonRestBaseUrl?: string;
+    /** Enable @bancor/carbon-sdk fallback when REST fails (default true). */
+    carbonSdkFallback?: boolean;
+    /** Self Agent ID signing key (Node only; also reads `SELF_AGENT_PRIVATE_KEY`). */
+    selfAgentPrivateKey?: `0x${string}`;
+    /** Self Agent ID REST API base (default https://app.ai.self.xyz). */
+    selfApiBase?: string;
+    /** Amplitude read telemetry (default on; opt out with `false` or `CELINA_ANALYTICS_DISABLED=1`). */
+    analyticsEnabled?: boolean;
+    /** Override bundled Amplitude project API key. */
+    amplitudeApiKey?: string;
+    /** Amplitude `device_id` (default `celina-sdk`). */
+    analyticsDeviceId?: string;
 }
 /** Default Celo RPC when `rpcUrl` is omitted. */
 export declare const DEFAULT_RPC_URL = "https://forno.celo.org";

package/build/config/sdk-config.js

@@ -5,9 +5,25 @@ export const DEFAULT_RPC_URL = "https://forno.celo.org";
  * @param opts - Optional RPC overrides from `createCelinaClient(opts)`
  */
 export function resolveSdkConfig(opts) {
+    const selfAgentPrivateKey = opts?.selfAgentPrivateKey ??
+        (typeof process !== "undefined"
+            ? process.env.SELF_AGENT_PRIVATE_KEY
+            : undefined);
     return {
         rpcUrl: opts?.rpcUrl ?? DEFAULT_RPC_URL,
         ethRpcUrl: opts?.ethRpcUrl,
+        carbonRestBaseUrl: opts?.carbonRestBaseUrl ??
+            process.env.CARBON_API_BASE_URL ??
+            "https://mcp.carbondefi.xyz",
+        carbonSdkFallback: opts?.carbonSdkFallback ?? true,
+        selfAgentPrivateKey,
+        selfApiBase: opts?.selfApiBase ??
+            (typeof process !== "undefined"
+                ? process.env.SELF_AGENT_API_BASE
+                : undefined),
+        analyticsEnabled: opts?.analyticsEnabled,
+        amplitudeApiKey: opts?.amplitudeApiKey,
+        analyticsDeviceId: opts?.analyticsDeviceId,
     };
 }
 //# sourceMappingURL=sdk-config.js.map

package/build/config/sdk-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-config.js","sourceRoot":"","sources":["../../src/config/sdk-config.ts"],"names":[],"mappings":"AAQA,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAyB;IACxD,OAAO;QACL,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,eAAe;QACvC,SAAS,EAAE,IAAI,EAAE,SAAS;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sdk-config.js","sourceRoot":"","sources":["../../src/config/sdk-config.ts"],"names":[],"mappings":"AAsBA,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAyB;IACxD,MAAM,mBAAmB,GACvB,IAAI,EAAE,mBAAmB;QACzB,CAAC,OAAO,OAAO,KAAK,WAAW;YAC7B,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,sBAAoD;YACnE,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,OAAO;QACL,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,eAAe;QACvC,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,iBAAiB,EACf,IAAI,EAAE,iBAAiB;YACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC/B,4BAA4B;QAC9B,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,IAAI,IAAI;QAClD,mBAAmB;QACnB,WAAW,EACT,IAAI,EAAE,WAAW;YACjB,CAAC,OAAO,OAAO,KAAK,WAAW;gBAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;gBACjC,CAAC,CAAC,SAAS,CAAC;QAChB,gBAAgB,EAAE,IAAI,EAAE,gBAAgB;QACxC,eAAe,EAAE,IAAI,EAAE,eAAe;QACtC,iBAAiB,EAAE,IAAI,EAAE,iBAAiB;KAC3C,CAAC;AACJ,CAAC"}

package/build/config/self.d.ts

@@ -0,0 +1,22 @@
+export declare const SELF_REGISTRY_ADDRESS: "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export declare const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export declare const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export declare const SELF_DEMO_NETWORK = "celo-mainnet";
+export declare const SELF_CHAIN_ID = 42220;
+export declare function selfDemoUrl(path: string, network?: string): string;
+export declare const SELF_SESSION_TTL_MS: number;
+export declare const SELF_MAX_SESSIONS = 50;
+export declare const SELF_DEFAULT_MAX_AGE_MS: number;
+export declare const SELF_FETCH_MAX_BYTES: number;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export declare const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export declare const SELF_HEADERS: {
+    readonly ADDRESS: "x-self-agent-address";
+    readonly SIGNATURE: "x-self-agent-signature";
+    readonly TIMESTAMP: "x-self-agent-timestamp";
+    readonly KEYTYPE: "x-self-agent-keytype";
+    readonly KEY: "x-self-agent-key";
+};
+export type SelfRegistrationMode = "linked" | "wallet-free" | "smartwallet" | "self-custody" | "ed25519" | "ed25519-linked";

package/build/config/self.js

@@ -0,0 +1,27 @@
+export const SELF_REGISTRY_ADDRESS = "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export const SELF_DEMO_NETWORK = "celo-mainnet";
+export const SELF_CHAIN_ID = 42220;
+export function selfDemoUrl(path, network = SELF_DEMO_NETWORK) {
+    const base = SELF_API_BASE.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const separator = normalizedPath.includes("?") ? "&" : "?";
+    return `${base}${normalizedPath}${separator}network=${network}`;
+}
+export const SELF_SESSION_TTL_MS = 10 * 60 * 1000;
+export const SELF_MAX_SESSIONS = 50;
+export const SELF_DEFAULT_MAX_AGE_MS = 5 * 60 * 1000;
+export const SELF_FETCH_MAX_BYTES = 10 * 1024;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export const SELF_HEADERS = {
+    ADDRESS: "x-self-agent-address",
+    SIGNATURE: "x-self-agent-signature",
+    TIMESTAMP: "x-self-agent-timestamp",
+    KEYTYPE: "x-self-agent-keytype",
+    KEY: "x-self-agent-key",
+};
+//# sourceMappingURL=self.js.map

package/build/config/self.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../src/config/self.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAChC,4CAAqD,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEvD,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAO,GAAG,iBAAiB;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,WAAW,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,GAAG,EAAE,kBAAkB;CACf,CAAC"}

package/build/index.d.ts

@@ -12,6 +12,8 @@ import { NftService } from "./services/nft.service.js";
 import { StakingService } from "./services/staking.service.js";
 import { TokenService } from "./services/token.service.js";
 import { TransactionService } from "./services/transaction.service.js";
+import { CarbonService } from "./services/carbon.service.js";
+import { SelfService } from "./services/self.service.js";
 /** Optional RPC overrides when creating a Celina client. */
 export type CelinaClientOptions = Partial<SdkConfig>;
 /** Domain services for Celo mainnet reads and unsigned transaction preparation. */
@@ -30,7 +32,7 @@ export interface CelinaClient {
     uniswap: UniswapService;
     /** Aave V3 `prepareSupply` and `prepareWithdraw` flows on Celo. */
     aave: AaveService;
-    /** GoodDollar IdentityV4 whitelist status. */
+    /** GoodDollar IdentityV4 whitelist status and daily UBI claim preparation. */
     gooddollar: GoodDollarService;
     /** Celo and Ethereum ENS resolution. */
     ens: EnsService;
@@ -42,6 +44,10 @@ export interface CelinaClient {
     nft: NftService;
     /** Generic read-only contract calls and gas estimates. */
     contract: ContractService;
+    /** Carbon DeFi maker strategies and taker trades on Celo (SDK + REST). */
+    carbon: CarbonService;
+    /** Self Agent ID on Celo mainnet (ai.self.xyz + on-chain registry). */
+    self: SelfService;
 }
 /**
  * Create a Celina client for Celo mainnet reads and unsigned tx preparation.
@@ -73,3 +79,14 @@ export type { ContractCallParams } from "./services/contract.service.js";
 /** Aave V3 Celo pool address and supported asset symbols. */
 export { AAVE_POOL, AAVE_SUPPORTED_SYMBOLS, resolveAaveAsset, } from "./config/aave.js";
 export type { AaveAsset } from "./config/aave.js";
+export { GOODDOLLAR_IDENTITY_ADDRESS, GOODDOLLAR_UBI_SCHEME_ADDRESS, } from "./config/gooddollar.js";
+export type { CarbonPrepareResult, CarbonRestSuccess, } from "./types/carbon.js";
+export type { CarbonWriteBody } from "./services/carbon.service.js";
+export { CARBON_CHAIN, CELO_CARBON_CONTRACTS, DEFAULT_CARBON_REST_BASE_URL, } from "./config/carbon.js";
+export { CarbonRestError } from "./clients/carbon-rest.js";
+export { SelfService, type VerifySelfAgentParams, type VerifySelfRequestParams, type RegisterSelfAgentParams, } from "./services/self.service.js";
+export { SelfApiError, SelfExpiredSessionError, } from "./clients/self-api.js";
+export type { SelfRegistrationMode } from "./config/self.js";
+export { selfDemoUrl, SELF_DEMO_NETWORK, SELF_HEADERS, } from "./config/self.js";
+export { resolveSelfSessionLinks, formatSelfSessionLinksDisplay, type SelfSessionLinks, } from "./utils/self-format.js";
+export { clearSelfSessionsForTests } from "./services/self-session-store.js";

package/build/index.js

@@ -20,6 +20,9 @@ import { NftService } from "./services/nft.service.js";
 import { StakingService } from "./services/staking.service.js";
 import { TokenService } from "./services/token.service.js";
 import { TransactionService } from "./services/transaction.service.js";
+import { CarbonService } from "./services/carbon.service.js";
+import { SelfService } from "./services/self.service.js";
+import { wrapServiceForAnalytics } from "./analytics/wrap-service.js";
 /**
  * Create a Celina client for Celo mainnet reads and unsigned tx preparation.
  * No private keys — pass prepared `steps` to wagmi/viem for wallet signing.
@@ -28,23 +31,35 @@ export function createCelinaClient(opts) {
     const config = resolveSdkConfig(opts);
     const clientFactory = new CeloClientFactory(config);
     const ensClientFactory = new EnsClientFactory(config);
+    const tokenService = new TokenService(clientFactory);
+    const wrap = (key, service) => wrapServiceForAnalytics(key, service, config);
     return {
-        blockchain: new BlockchainService(clientFactory),
-        account: new AccountService(clientFactory),
-        token: new TokenService(clientFactory),
-        transaction: new TransactionService(clientFactory),
-        mentoFx: new MentoFxService(clientFactory),
-        uniswap: new UniswapService(clientFactory),
-        aave: new AaveService(clientFactory),
-        gooddollar: new GoodDollarService(clientFactory),
-        ens: new EnsService(ensClientFactory),
-        governance: new GovernanceService(clientFactory),
-        staking: new StakingService(clientFactory),
-        nft: new NftService(clientFactory),
-        contract: new ContractService(clientFactory),
+        blockchain: wrap("blockchain", new BlockchainService(clientFactory)),
+        account: wrap("account", new AccountService(clientFactory)),
+        token: wrap("token", tokenService),
+        transaction: wrap("transaction", new TransactionService(clientFactory)),
+        mentoFx: wrap("mentoFx", new MentoFxService(clientFactory)),
+        uniswap: wrap("uniswap", new UniswapService(clientFactory)),
+        aave: wrap("aave", new AaveService(clientFactory)),
+        gooddollar: wrap("gooddollar", new GoodDollarService(clientFactory)),
+        ens: wrap("ens", new EnsService(ensClientFactory)),
+        governance: wrap("governance", new GovernanceService(clientFactory)),
+        staking: wrap("staking", new StakingService(clientFactory)),
+        nft: wrap("nft", new NftService(clientFactory)),
+        contract: wrap("contract", new ContractService(clientFactory)),
+        carbon: wrap("carbon", new CarbonService(config, tokenService)),
+        self: wrap("self", new SelfService(clientFactory, config)),
     };
 }
 export { serializePreparedFlow } from "./types/prepared.js";
 /** Aave V3 Celo pool address and supported asset symbols. */
 export { AAVE_POOL, AAVE_SUPPORTED_SYMBOLS, resolveAaveAsset, } from "./config/aave.js";
+export { GOODDOLLAR_IDENTITY_ADDRESS, GOODDOLLAR_UBI_SCHEME_ADDRESS, } from "./config/gooddollar.js";
+export { CARBON_CHAIN, CELO_CARBON_CONTRACTS, DEFAULT_CARBON_REST_BASE_URL, } from "./config/carbon.js";
+export { CarbonRestError } from "./clients/carbon-rest.js";
+export { SelfService, } from "./services/self.service.js";
+export { SelfApiError, SelfExpiredSessionError, } from "./clients/self-api.js";
+export { selfDemoUrl, SELF_DEMO_NETWORK, SELF_HEADERS, } from "./config/self.js";
+export { resolveSelfSessionLinks, formatSelfSessionLinksDisplay, } from "./utils/self-format.js";
+export { clearSelfSessionsForTests } from "./services/self-session-store.js";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAmCvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;QACL,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC;QACrC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,GAAG,EAAE,IAAI,UAAU,CAAC,aAAa,CAAC;QAClC,QAAQ,EAAE,IAAI,eAAe,CAAC,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAYD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAa5D,6DAA6D;AAC7D,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/services/carbon.service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Carbon DeFi on Celo — hybrid @bancor/carbon-sdk + Carbon REST (mcp.carbondefi.xyz).
+ * REST is primary for all 25 MCP tools; SDK is fallback for quotes/trades when REST fails.
+ */
+import type { SdkConfig } from "../config/sdk-config.js";
+import type { CarbonPrepareResult, CarbonRestSuccess } from "../types/carbon.js";
+import type { TokenService } from "./token.service.js";
+export type CarbonWriteBody = Record<string, unknown> & {
+    wallet_address: `0x${string}`;
+};
+export declare class CarbonService {
+    private readonly tokenService;
+    private readonly rest;
+    private readonly sdk;
+    constructor(config: SdkConfig, tokenService: TokenService);
+    private restRead;
+    private restPrepare;
+    private withSdkFallback;
+    getStrategies(walletAddress: `0x${string}`): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getStrategy(strategyId: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    prepareLimitOrder(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRangeOrder(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRecurringStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareConcentratedStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareFullRangeStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareRepriceStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareEditStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareDepositBudget(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareWithdrawBudget(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    preparePauseStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareResumeStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    prepareDeleteStrategy(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    getTradeQuote(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    prepareTrade(body: CarbonWriteBody): Promise<CarbonPrepareResult>;
+    explorePair(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    resolveToken(symbolOrName: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getActivity(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    findOpportunities(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getProtocolStats(body?: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    getPriceHistory(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    simulateStrategy(body: Record<string, unknown>): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    help(topic?: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+    learn(topic?: string): Promise<CarbonRestSuccess & {
+        warnings: string[];
+    }>;
+}

package/build/services/carbon.service.js

@@ -0,0 +1,189 @@
+import { CarbonRestClient } from "../clients/carbon-rest.js";
+import { CarbonSdkClient } from "../clients/carbon-sdk.js";
+import { extractWarnings, normalizeCarbonPrepareResult, } from "../utils/carbon-rest-adapter.js";
+function walletAddress(value) {
+    return value;
+}
+export class CarbonService {
+    tokenService;
+    rest;
+    sdk;
+    constructor(config, tokenService) {
+        this.tokenService = tokenService;
+        this.rest = new CarbonRestClient(config.carbonRestBaseUrl);
+        this.sdk =
+            config.carbonSdkFallback !== false
+                ? new CarbonSdkClient(config.rpcUrl)
+                : null;
+    }
+    async restRead(tool, body = {}) {
+        const result = await this.rest.postTool(tool, body);
+        return { ...result, warnings: extractWarnings(result) };
+    }
+    async restPrepare(tool, body, summary) {
+        const from = walletAddress(body.wallet_address);
+        const result = await this.rest.postTool(tool, body);
+        return normalizeCarbonPrepareResult(from, result, summary);
+    }
+    async withSdkFallback(restFn, fallbackFn) {
+        try {
+            return await restFn();
+        }
+        catch (primary) {
+            if (!this.sdk)
+                throw primary;
+            return fallbackFn();
+        }
+    }
+    // --- Read (2) ---
+    async getStrategies(walletAddress) {
+        return this.restRead("get_strategies", { wallet_address: walletAddress });
+    }
+    async getStrategy(strategyId) {
+        return this.restRead("get_strategy", { strategy_id: strategyId });
+    }
+    // --- Create (5) ---
+    async prepareLimitOrder(body) {
+        return this.restPrepare("create_limit_order", body, "Carbon limit order");
+    }
+    async prepareRangeOrder(body) {
+        return this.restPrepare("create_range_order", body, "Carbon range order");
+    }
+    async prepareRecurringStrategy(body) {
+        return this.restPrepare("create_recurring_strategy", body, "Carbon recurring strategy");
+    }
+    async prepareConcentratedStrategy(body) {
+        return this.restPrepare("create_concentrated_strategy", body, "Carbon concentrated strategy");
+    }
+    async prepareFullRangeStrategy(body) {
+        return this.restPrepare("create_full_range_strategy", body, "Carbon full-range strategy");
+    }
+    // --- Manage (7) ---
+    async prepareRepriceStrategy(body) {
+        return this.restPrepare("reprice_strategy", body, "Carbon reprice strategy");
+    }
+    async prepareEditStrategy(body) {
+        return this.restPrepare("edit_strategy", body, "Carbon edit strategy");
+    }
+    async prepareDepositBudget(body) {
+        return this.restPrepare("deposit_budget", body, "Carbon deposit budget");
+    }
+    async prepareWithdrawBudget(body) {
+        return this.restPrepare("withdraw_budget", body, "Carbon withdraw budget");
+    }
+    async preparePauseStrategy(body) {
+        return this.restPrepare("pause_strategy", body, "Carbon pause strategy");
+    }
+    async prepareResumeStrategy(body) {
+        return this.restPrepare("resume_strategy", body, "Carbon resume strategy");
+    }
+    async prepareDeleteStrategy(body) {
+        return this.restPrepare("delete_strategy", body, "Carbon delete strategy");
+    }
+    // --- Trade (2) ---
+    async getTradeQuote(body) {
+        const amount = typeof body.amount === "string" ? Number(body.amount) : body.amount;
+        const normalized = {
+            ...body,
+            amount,
+            ...(body.is_trade_by_target !== undefined
+                ? { by_target: body.is_trade_by_target }
+                : {}),
+        };
+        return this.withSdkFallback(() => this.restRead("get_trade_quote", normalized), async () => {
+            if (!this.sdk)
+                throw new Error("Carbon SDK fallback unavailable");
+            const sourceToken = String(body.source_token ?? body.token_in);
+            const targetToken = String(body.target_token ?? body.token_out);
+            const amountStr = String(amount);
+            const isTradeByTarget = Boolean(body.is_trade_by_target ?? body.by_target);
+            const { tradeData } = await this.sdk.getTradeQuoteFallback(sourceToken, targetToken, amountStr, isTradeByTarget);
+            return {
+                status: "ok",
+                warnings: [],
+                source: "sdk_fallback",
+                ...tradeData,
+            };
+        });
+    }
+    async prepareTrade(body) {
+        try {
+            return await this.restPrepare("execute_trade", body, "Carbon taker swap");
+        }
+        catch (primary) {
+            if (!this.sdk)
+                throw primary;
+            const sourceToken = String(body.source_token ?? body.token_in);
+            const targetToken = String(body.target_token ?? body.token_out);
+            const amount = String(body.amount);
+            const minReturn = String(body.min_return ?? "0");
+            const preparedFlow = await this.sdk.prepareTradeFallback(walletAddress(body.wallet_address), sourceToken, targetToken, amount, false, minReturn);
+            return {
+                status: "ok",
+                warnings: [],
+                preparedFlow,
+                source: "sdk_fallback",
+            };
+        }
+    }
+    // --- Explore (8) ---
+    async explorePair(body) {
+        return this.restRead("explore_pair", body);
+    }
+    async resolveToken(symbolOrName) {
+        try {
+            return await this.restRead("resolve_token", {
+                token: symbolOrName,
+            });
+        }
+        catch {
+            const resolved = this.tokenService.resolveToken(symbolOrName);
+            return {
+                status: "ok",
+                warnings: [],
+                symbol: resolved.symbol,
+                address: resolved.address,
+                decimals: resolved.decimals,
+                source: "celina_registry",
+            };
+        }
+    }
+    async getActivity(body) {
+        return this.restRead("get_activity", body);
+    }
+    async findOpportunities(body) {
+        return this.restRead("find_opportunities", body);
+    }
+    async getProtocolStats(body = {}) {
+        const { period_days, ...rest } = body;
+        return this.restRead("get_protocol_stats", {
+            ...rest,
+            ...(period_days !== undefined ? { days: period_days } : {}),
+        });
+    }
+    async getPriceHistory(body) {
+        const { period_days, days, ...rest } = body;
+        const lookback = days ?? period_days;
+        return this.restRead("get_price_history", {
+            ...rest,
+            ...(lookback !== undefined ? { days: lookback } : {}),
+        });
+    }
+    async simulateStrategy(body) {
+        const { days, ...rest } = body;
+        if (rest.start === undefined && rest.end === undefined && days !== undefined) {
+            const end = Math.floor(Date.now() / 1000);
+            const start = end - Number(days) * 86_400;
+            return this.restRead("simulate_strategy", { ...rest, start, end });
+        }
+        return this.restRead("simulate_strategy", body);
+    }
+    // --- Help (2) ---
+    async help(topic) {
+        return this.restRead("help", topic ? { topic } : {});
+    }
+    async learn(topic) {
+        return this.restRead("learn", topic ? { topic } : {});
+    }
+}
+//# sourceMappingURL=carbon.service.js.map

package/build/services/carbon.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon.service.js","sourceRoot":"","sources":["../../src/services/carbon.service.ts"],"names":[],"mappings":"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"}

package/build/services/gooddollar.service.d.ts

@@ -1,11 +1,10 @@
-/**
- * GoodDollar IdentityV4 whitelist and reverification reads on Celo mainnet.
- */
 import type { CeloClientFactory } from "../clients/celo-client.js";
+import { type SerializedPreparedFlow } from "../types/prepared.js";
 /** GoodDollar IdentityV4 whitelist status and reverification progress. */
 export declare class GoodDollarService {
     private readonly clientFactory;
     constructor(clientFactory: CeloClientFactory);
+    private getPublicClient;
     /**
      * GoodDollar IdentityV4 whitelist status and reverification progress for a wallet.
      * @param address - Wallet to check against IdentityV4
@@ -41,6 +40,45 @@ export declare class GoodDollarService {
             authCount: number;
         };
     }>;
+    /**
+     * Daily UBI claim eligibility for a wallet against UBISchemeV2 on Celo.
+     * Resolves connected wallets via Identity `getWhitelistedRoot`.
+     */
+    getUbiClaimEligibility(address: `0x${string}`): Promise<{
+        address: `0x${string}`;
+        contract: "0x43d72Ff17701B2DA814620735C39C620Ce0ea4A1";
+        whitelistedRoot: `0x${string}` | null;
+        isConnectedWallet: boolean;
+        isEligibleToClaim: boolean;
+        claimableAmount: string;
+        claimableAmountFormatted: string;
+        alreadyClaimedToday: boolean;
+        schemePaused: boolean;
+        schemeStarted: boolean;
+        estimatedDailyUbi: string;
+        estimatedDailyUbiFormatted: string;
+        currentDailyUbi: string;
+        currentDailyUbiFormatted: string;
+        reasons: string[];
+        identity: {
+            isCurrentlyWhitelisted: boolean;
+            statusLabel: string;
+            reverification: {
+                daysSinceLastAuthentication: number;
+                currentReverificationPeriodDays: number;
+                maxReverificationPeriodDays: number;
+                daysUntilReverificationRequired: number;
+                reverificationRequiredOn: string;
+                reverificationProgressPercent: number;
+                isReverificationOverdue: boolean;
+            } | null;
+        };
+    }>;
+    /**
+     * Build an unsigned UBISchemeV2 `claim()` transaction for daily G$ UBI.
+     * Validates whitelist, entitlement, and simulates gas before returning steps.
+     */
+    prepareClaimUbi(from: `0x${string}`): Promise<SerializedPreparedFlow>;
     private effectiveAuthCount;
     private fetchReverifyDaysOptions;
     private buildReverificationProgress;