@aboutcircles/sdk-types 0.1.0

package/dist/avatar.d.ts

@@ -0,0 +1,102 @@
+import type { Address } from './base';
+/**
+ * Avatar and profile types
+ */
+/**
+ * Avatar information
+ * Contains basic information about a Circles avatar.
+ */
+export interface AvatarInfo {
+    /**
+     * The block number of the event
+     */
+    blockNumber: number;
+    /**
+     * The timestamp of the last change to the avatar
+     * Note: May be undefined for some avatars
+     */
+    timestamp?: number;
+    /**
+     * The transaction index
+     */
+    transactionIndex: number;
+    /**
+     * The log index
+     */
+    logIndex: number;
+    /**
+     * The hash of the transaction that last changed the avatar
+     */
+    transactionHash: string;
+    /**
+     * If the avatar is currently active in version 1 or 2
+     * Note: An avatar that's active in v2 can still have a v1 token. See `hasV1` and `v1Token`.
+     */
+    version: number;
+    /**
+     * The type of the avatar
+     */
+    type: 'CrcV2_RegisterHuman' | 'CrcV2_RegisterGroup' | 'CrcV2_RegisterOrganization' | 'CrcV1_Signup' | 'CrcV1_OrganizationSignup';
+    /**
+     * The address of the avatar
+     */
+    avatar: Address;
+    /**
+     * The personal or group token address (v1) or tokenId (v2)
+     * Note: v1 tokens are erc20 and have a token address. v2 tokens are erc1155 and have a tokenId.
+     *       The v2 tokenId is always an encoded version of the avatar address.
+     */
+    tokenId?: string;
+    /**
+     * If the avatar is signed up at v1
+     */
+    hasV1: boolean;
+    /**
+     * If the avatar has a v1 token, this is the token address
+     */
+    v1Token?: Address;
+    /**
+     * The bytes of the avatar's metadata cidv0
+     */
+    cidV0Digest?: string;
+    /**
+     * The CIDv0 of the avatar's metadata (profile)
+     */
+    cidV0?: string;
+    /**
+     * If the avatar is stopped in v1
+     * Note: This is only set during Avatar initialization.
+     */
+    v1Stopped?: boolean;
+    /**
+     * Indicates whether the entity is a human
+     */
+    isHuman: boolean;
+    /**
+     * Groups have a name
+     */
+    name?: string;
+    /**
+     * Groups have a symbol
+     */
+    symbol?: string;
+}
+/**
+ * Profile information
+ */
+export interface Profile {
+    name: string;
+    description?: string;
+    previewImageUrl?: string;
+    imageUrl?: string;
+    location?: string;
+    geoLocation?: [number, number];
+    extensions?: Record<string, any>;
+}
+/**
+ * Group profile with additional symbol field
+ */
+export interface GroupProfile extends Profile {
+    symbol: string;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../src/avatar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EACA,qBAAqB,GACrB,qBAAqB,GACrB,4BAA4B,GAC5B,cAAc,GACd,0BAA0B,CAAC;IAC/B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/avatar.js

@@ -0,0 +1 @@
+export {};

package/dist/base.d.ts

@@ -0,0 +1,45 @@
+import type { Abi, Address as ViemAddress } from 'abitype';
+/**
+ * Base types for EVM interaction
+ */
+/**
+ * Ethereum address type
+ */
+export type Address = ViemAddress;
+/**
+ * Hexadecimal string type
+ */
+export type Hex = `0x${string}`;
+/**
+ * Transaction or block hash type
+ */
+export type Hash = `0x${string}`;
+/**
+ * Generic contract configuration
+ */
+export interface ContractConfig<TAbi extends Abi = Abi> {
+    address: Address;
+    abi: TAbi;
+}
+/**
+ * Transaction request object
+ * Contains all data needed to send a transaction
+ */
+export interface TransactionRequest {
+    from?: Address;
+    to: Address;
+    data: Hex;
+    value?: bigint;
+    gas?: bigint;
+    gasPrice?: bigint;
+    nonce?: number;
+}
+/**
+ * Call result
+ */
+export interface CallResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3D;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,GAAG,GAAG,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,IAAI,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/dist/base.js

@@ -0,0 +1 @@
+export {};

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+import type { Address } from './base';
+/**
+ * Configuration types
+ */
+/**
+ * Circles protocol configuration for a specific chain
+ */
+export interface CirclesConfig {
+    /** RPC URL for Circles-specific endpoints */
+    circlesRpcUrl: string;
+    /** Pathfinder service URL for computing transfer paths */
+    pathfinderUrl: string;
+    /** Profile service URL for user profiles and metadata */
+    profileServiceUrl: string;
+    /** Circles V1 Hub contract address */
+    v1HubAddress: Address;
+    /** Circles V2 Hub contract address */
+    v2HubAddress: Address;
+    /** Name Registry contract address */
+    nameRegistryAddress: Address;
+    /** Base Group Mint Policy contract address */
+    baseGroupMintPolicy: Address;
+    /** Standard Treasury contract address */
+    standardTreasury: Address;
+    /** Core Members Group Deployer contract address */
+    coreMembersGroupDeployer: Address;
+    /** Base Group Factory contract address */
+    baseGroupFactoryAddress: Address;
+    /** Lift ERC20 contract address */
+    liftERC20Address: Address;
+    /** Invitation Escrow contract address */
+    invitationEscrowAddress: Address;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,8CAA8C;IAC9C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,yCAAyC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,wBAAwB,EAAE,OAAO,CAAC;IAClC,0CAA0C;IAC1C,uBAAuB,EAAE,OAAO,CAAC;IACjC,kCAAkC;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,uBAAuB,EAAE,OAAO,CAAC;CAClC"}

package/dist/config.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Contract types
+ * Types for contract-specific data structures and responses
+ */
+/**
+ * Escrowed Amount and Days Result
+ * Returned by InvitationEscrow.getEscrowedAmountAndDays()
+ */
+export interface EscrowedAmountAndDays {
+    escrowedAmount: bigint;
+    days_: bigint;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/contracts.js

@@ -0,0 +1,5 @@
+/**
+ * Contract types
+ * Types for contract-specific data structures and responses
+ */
+export {};

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Decoded contract error information
+ * Contains parsed error data from failed contract transactions
+ */
+export interface DecodedContractError {
+    errorName: string;
+    args?: any[];
+    selector: string;
+    rawData: string;
+    formattedMessage: string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/errors.js

@@ -0,0 +1 @@
+export {};

package/dist/events.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Events types
+ */
+export type CirclesBaseEvent = {
+    blockNumber: number;
+    timestamp?: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash?: string;
+};
+export type CirclesEventType = 'CrcV2_ApprovalForAll' | 'CrcV2_DiscountCost' | 'CrcV2_FlowEdgesScopeLastEnded' | 'CrcV2_FlowEdgesScopeSingleStarted' | 'CrcV2_GroupMint' | 'CrcV2_PersonalMint' | 'CrcV2_RegisterGroup' | 'CrcV2_RegisterHuman' | 'CrcV2_RegisterOrganization' | 'CrcV2_SetAdvancedUsageFlag' | 'CrcV2_Stopped' | 'CrcV2_StreamCompleted' | 'CrcV2_TransferBatch' | 'CrcV2_TransferSingle' | 'CrcV2_Trust' | 'CrcV2_URI' | 'CrcV2_Approval' | 'CrcV2_DepositDemurraged' | 'CrcV2_DepositInflationary' | 'CrcV2_EIP712DomainChanged' | 'CrcV2_Transfer' | 'CrcV2_WithdrawDemurraged' | 'CrcV2_WithdrawInflationary' | 'CrcV2_CidV0' | 'CrcV2_RegisterShortName' | 'CrcV2_UpdateMetadataDigest' | 'CrcV2_GroupRedeemCollateralBurn' | 'CrcV2_GroupRedeemCollateralReturn' | 'CrcV2_InviteHuman' | 'Crc_UnknownEvent';
+export type CirclesEvent = CirclesBaseEvent & {
+    $event: CirclesEventType;
+    [key: string]: any;
+};
+export type CirclesEventOfType<T extends CirclesEventType> = CirclesEvent & {
+    $event: T;
+};
+export type RpcSubscriptionEvent = {
+    event: string;
+    values: Record<string, any>;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAExB,sBAAsB,GACtB,oBAAoB,GACpB,+BAA+B,GAC/B,mCAAmC,GACnC,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,4BAA4B,GAC5B,4BAA4B,GAC5B,eAAe,GACf,uBAAuB,GACvB,qBAAqB,GACrB,sBAAsB,GACtB,aAAa,GACb,WAAW,GAEX,gBAAgB,GAChB,yBAAyB,GACzB,2BAA2B,GAC3B,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,4BAA4B,GAE5B,aAAa,GACb,yBAAyB,GACzB,4BAA4B,GAE5B,iCAAiC,GACjC,mCAAmC,GAEnC,mBAAmB,GAEnB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,MAAM,EAAE,gBAAgB,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,IAAI,YAAY,GAAG;IAC1E,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC"}

package/dist/events.js

@@ -0,0 +1,4 @@
+/**
+ * Events types
+ */
+export {};

package/dist/group.d.ts

@@ -0,0 +1,54 @@
+import type { Address } from './base';
+/**
+ * Group-related types
+ */
+/**
+ * Group row information
+ */
+export interface GroupRow {
+    blockNumber: number;
+    timestamp: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash: string;
+    group: Address;
+    type: string;
+    owner: Address;
+    mintPolicy?: Address;
+    mintHandler?: Address;
+    treasury?: Address;
+    service?: Address;
+    feeCollection?: Address;
+    memberCount?: number;
+    name?: string;
+    symbol?: string;
+    cidV0Digest?: string;
+    erc20WrapperDemurraged?: Address;
+    erc20WrapperStatic?: Address;
+}
+/**
+ * Group membership row
+ */
+export interface GroupMembershipRow {
+    blockNumber: number;
+    timestamp: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash: string;
+    group: Address;
+    member: Address;
+    expiryTime: number;
+}
+/**
+ * Group query parameters
+ */
+export interface GroupQueryParams {
+    nameStartsWith?: string;
+    symbolStartsWith?: string;
+    groupAddressIn?: Address[];
+    groupTypeIn?: string[];
+    ownerIn?: Address[];
+    mintHandlerEquals?: Address;
+    treasuryEquals?: Address;
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../src/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/group.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Circles SDK Types
+ *
+ * All types are organized by domain for better maintainability
+ */
+export type { Address, Hex, Hash, ContractConfig, TransactionRequest, CallResult, } from './base';
+export type { JsonRpcRequest, JsonRpcResponse, CirclesQueryResponse, QueryResponse } from './rpc';
+export type { FilterType, ConjunctionType, FilterPredicate, Conjunction, Filter, SortOrder, OrderBy, QueryParams, TableInfo, EventRow, Cursor, PagedResult, PagedQueryParams, } from './query';
+export type { AvatarInfo, Profile, GroupProfile } from './avatar';
+export type { TokenBalance, TokenInfo, TokenHolder } from './token';
+export type { TrustRelation, TrustRelationType, AggregatedTrustRelation } from './trust';
+export type { GroupRow, GroupMembershipRow, GroupQueryParams } from './group';
+export type { SimulatedBalance, FindPathParams, TransferStep, PathfindingResult, FlowEdgeStruct, StreamStruct, FlowMatrix, AdvancedTransferOptions, } from './pathfinding';
+export type { EventType, NetworkSnapshot } from './network';
+export type { CirclesConfig } from './config';
+export { CirclesType } from './wrapper';
+export type { WrappedTokenInfo, WrappedTokensRecord } from './wrapper';
+export { GroupType } from './sdk';
+export type { AvatarRow, TokenBalanceRow, TrustRelationRow, CirclesQuery } from './sdk';
+export type { CirclesBaseEvent, CirclesEventType, CirclesEvent, CirclesEventOfType, RpcSubscriptionEvent } from './events';
+export type { BatchRun, ContractRunner } from './runner';
+export type { EscrowedAmountAndDays } from './contracts';
+export type { DecodedContractError } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,OAAO,EACP,GAAG,EACH,IAAI,EACJ,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlG,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,MAAM,EACN,SAAS,EACT,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAM,EACN,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGzF,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG9E,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGxF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAI3H,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// src/wrapper.ts
+var CirclesType;
+((CirclesType2) => {
+  CirclesType2[CirclesType2["Demurrage"] = 0] = "Demurrage";
+  CirclesType2[CirclesType2["Inflation"] = 1] = "Inflation";
+})(CirclesType ||= {});
+// src/sdk.ts
+var GroupType;
+((GroupType2) => {
+  GroupType2["Standard"] = "Standard";
+  GroupType2["Custom"] = "Custom";
+})(GroupType ||= {});
+export {
+  GroupType,
+  CirclesType
+};

package/dist/network.d.ts

@@ -0,0 +1,19 @@
+import type { TrustRelation } from './trust';
+import type { TokenBalance } from './token';
+/**
+ * Network and event types
+ */
+/**
+ * Event types
+ */
+export type EventType = 'CrcV1_Trust' | 'CrcV1_HubTransfer' | 'CrcV1_Signup' | 'CrcV1_OrganizationSignup' | 'CrcV2_RegisterHuman' | 'CrcV2_RegisterOrganization' | 'CrcV2_RegisterGroup' | 'CrcV2_Trust' | 'CrcV2_TransferSingle' | 'CrcV2_TransferBatch';
+/**
+ * Network snapshot structure
+ */
+export interface NetworkSnapshot {
+    trustRelations: TrustRelation[];
+    balances: TokenBalance[];
+    blockNumber: number;
+    timestamp: number;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,mBAAmB,GACnB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,4BAA4B,GAC5B,qBAAqB,GACrB,aAAa,GACb,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/network.js

@@ -0,0 +1 @@
+export {};

package/dist/pathfinding.d.ts

@@ -0,0 +1,84 @@
+import type { Address, Hex } from './base';
+/**
+ * Pathfinding types
+ */
+/**
+ * Simulated balance for path finding
+ */
+export interface SimulatedBalance {
+    holder: Address;
+    token: Address;
+    amount: bigint;
+    isWrapped: boolean;
+    isStatic: boolean;
+}
+/**
+ * Path finding parameters for circlesV2_findPath
+ */
+export interface FindPathParams {
+    from: Address;
+    to: Address;
+    targetFlow: bigint;
+    useWrappedBalances?: boolean;
+    fromTokens?: Address[];
+    toTokens?: Address[];
+    excludeFromTokens?: Address[];
+    excludeToTokens?: Address[];
+    simulatedBalances?: SimulatedBalance[];
+    maxTransfers?: number;
+}
+/**
+ * A single transfer step in a pathfinding result
+ */
+export interface TransferStep {
+    from: Address;
+    to: Address;
+    tokenOwner: string;
+    value: bigint;
+}
+/**
+ * Result of pathfinding computation
+ */
+export interface PathfindingResult {
+    maxFlow: bigint;
+    transfers: TransferStep[];
+}
+/**
+ * Flow edge structure for operateFlowMatrix
+ * Corresponds to TypeDefinitions.FlowEdge in the Hub V2 contract
+ */
+export interface FlowEdgeStruct {
+    streamSinkId: number;
+    amount: bigint;
+}
+/**
+ * Stream structure for operateFlowMatrix
+ * Corresponds to TypeDefinitions.Stream in the Hub V2 contract
+ */
+export interface StreamStruct {
+    sourceCoordinate: number;
+    flowEdgeIds: number[];
+    data: Uint8Array | Hex;
+}
+/**
+ * Flow matrix for ABI encoding
+ * Used with the operateFlowMatrix function in Hub V2
+ */
+export interface FlowMatrix {
+    flowVertices: string[];
+    flowEdges: FlowEdgeStruct[];
+    streams: StreamStruct[];
+    packedCoordinates: string;
+    sourceCoordinate: number;
+}
+/**
+ * Advanced transfer options
+ * Extends FindPathParams to add transfer-specific options
+ */
+export interface AdvancedTransferOptions extends Omit<FindPathParams, 'from' | 'to' | 'targetFlow'> {
+    /**
+     * Custom data to attach to the transfer (optional)
+     */
+    txData?: Uint8Array;
+}
+//# sourceMappingURL=pathfinding.d.ts.map

package/dist/pathfinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathfinding.d.ts","sourceRoot":"","sources":["../src/pathfinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE3C;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,UAAU,GAAG,GAAG,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC;IACjG;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB"}

package/dist/pathfinding.js

@@ -0,0 +1 @@
+export {};

package/dist/query.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Query and filter types for circles_query RPC method
+ */
+/**
+ * Filter types for query predicates
+ */
+export type FilterType = 'Equals' | 'NotEquals' | 'GreaterThan' | 'LessThan' | 'GreaterOrEqualThan' | 'LessOrEqualThan' | 'Like';
+/**
+ * Conjunction types for combining predicates
+ */
+export type ConjunctionType = 'And' | 'Or';
+/**
+ * Filter predicate for querying
+ */
+export interface FilterPredicate {
+    Type: 'FilterPredicate';
+    FilterType: FilterType;
+    Column: string;
+    Value: string | number | boolean;
+}
+/**
+ * Conjunction for combining multiple predicates
+ */
+export interface Conjunction {
+    Type: 'Conjunction';
+    ConjunctionType: ConjunctionType;
+    Predicates: (FilterPredicate | Conjunction)[];
+}
+/**
+ * Filter type (either a predicate or conjunction)
+ */
+export type Filter = FilterPredicate | Conjunction;
+/**
+ * Order direction for query results
+ */
+export type SortOrder = 'ASC' | 'DESC';
+/**
+ * Order by clause
+ */
+export interface OrderBy {
+    Column: string;
+    SortOrder: SortOrder;
+}
+/**
+ * Query parameters for circles_query
+ */
+export interface QueryParams {
+    Namespace: string;
+    Table: string;
+    Columns: string[];
+    Filter: Filter[];
+    Order: OrderBy[];
+    Limit?: number;
+}
+/**
+ * Table information from circles_tables
+ */
+export interface TableInfo {
+    Namespace: string;
+    Table: string;
+    Columns: {
+        Name: string;
+        Type: string;
+    }[];
+}
+/**
+ * Pagination types
+ */
+/**
+ * Defines the minimum columns any event row must have for cursor-based pagination.
+ * These values are important for determining cursor position in result sets.
+ */
+export interface EventRow {
+    blockNumber: number;
+    transactionIndex: number;
+    logIndex: number;
+    batchIndex?: number;
+    timestamp?: number;
+}
+/**
+ * A cursor is a sortable unique identifier for a specific log entry.
+ * Used to paginate through query results efficiently.
+ */
+export interface Cursor extends EventRow {
+}
+/**
+ * Result of a paginated query
+ */
+export interface PagedResult<TRow extends EventRow> {
+    /**
+     * The number of results that were requested
+     */
+    limit: number;
+    /**
+     * The number of results that were returned
+     */
+    size: number;
+    /**
+     * If the query returned results, this will be the cursor for the first result
+     */
+    firstCursor?: Cursor;
+    /**
+     * If the query returned results, this will be the cursor for the last result
+     */
+    lastCursor?: Cursor;
+    /**
+     * The sort order of the results
+     */
+    sortOrder: SortOrder;
+    /**
+     * Whether there are more results available
+     */
+    hasMore: boolean;
+    /**
+     * The results of the query
+     */
+    results: TRow[];
+}
+/**
+ * Parameters for a paginated query
+ */
+export interface PagedQueryParams {
+    /**
+     * The namespace of the table to query
+     */
+    namespace: string;
+    /**
+     * The name of the table to query
+     */
+    table: string;
+    /**
+     * The order to sort the results
+     */
+    sortOrder: SortOrder;
+    /**
+     * The columns to return in the results
+     */
+    columns: string[];
+    /**
+     * The filters to apply to the query
+     */
+    filter?: Filter[];
+    /**
+     * The number of results to return per page
+     */
+    limit: number;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,WAAW,GACX,aAAa,GACb,UAAU,GACV,oBAAoB,GACpB,iBAAiB,GACjB,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,CAAC,eAAe,GAAG,WAAW,CAAC,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,eAAe,GAAG,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;CACL;AAED;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAO,SAAQ,QAAQ;CAAG;AAE3C;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,QAAQ;IAChD;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,IAAI,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/query.js

@@ -0,0 +1,4 @@
+/**
+ * Query and filter types for circles_query RPC method
+ */
+export {};

package/dist/rpc.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JSON-RPC types
+ */
+/**
+ * JSON-RPC request structure
+ */
+export interface JsonRpcRequest<TParams = unknown[]> {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params: TParams;
+}
+/**
+ * JSON-RPC response structure
+ */
+export interface JsonRpcResponse<TResult = unknown> {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: TResult;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Circles query response format
+ * Used for circles_query RPC method results
+ */
+export interface CirclesQueryResponse {
+    columns: string[];
+    rows: any[][];
+}
+/**
+ * Generic query response wrapper
+ * Used for internal query transformations and type-safe responses
+ */
+export interface QueryResponse<T = unknown> {
+    result: T;
+    error?: unknown;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO,EAAE;IACjD,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,GAAG,OAAO;IAChD,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/rpc.js

@@ -0,0 +1,4 @@
+/**
+ * JSON-RPC types
+ */
+export {};

package/dist/runner.d.ts

@@ -0,0 +1,64 @@
+import type { Address, TransactionRequest } from './base';
+/**
+ * Runner types
+ * Core interfaces for contract execution and transaction handling
+ */
+/**
+ * Batch transaction runner interface
+ * Allows multiple transactions to be batched and executed atomically
+ */
+export interface BatchRun {
+    /**
+     * Add a transaction to the batch
+     */
+    addTransaction(tx: TransactionRequest): void;
+    /**
+     * Execute all batched transactions
+     * @returns Single transaction receipt for the entire batch
+     */
+    run(): Promise<any>;
+}
+/**
+ * Contract runner interface for executing blockchain operations
+ * This is the base interface that all contract runners must implement
+ */
+export interface ContractRunner {
+    /**
+     * The address of the account (if available)
+     */
+    address?: Address;
+    /**
+     * The public client for reading blockchain state
+     */
+    publicClient: any;
+    /**
+     * Initialize the runner
+     */
+    init(): Promise<void>;
+    /**
+     * Estimate gas for a transaction
+     */
+    estimateGas?(tx: TransactionRequest): Promise<bigint>;
+    /**
+     * Call a contract (read-only)
+     */
+    call?(tx: TransactionRequest): Promise<string>;
+    /**
+     * Resolve an ENS name to an address
+     */
+    resolveName?(name: string): Promise<string | null>;
+    /**
+     * Send one or more transactions
+     * - Safe: batches all transactions atomically and returns single TransactionReceipt
+     */
+    sendTransaction?(txs: TransactionRequest[]): Promise<any>;
+    /**
+     * Create a batch transaction runner (if supported)
+     * This allows multiple transactions to be executed atomically in a single on-chain transaction
+     * Typically used with Safe multisig or other smart contract wallets
+     *
+     * @returns A BatchRun instance for adding transactions and executing them as a batch
+     */
+    sendBatchTransaction?(): BatchRun;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE1D;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,GAAG,CAAC;IAElB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C;;OAEG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,eAAe,CAAC,CACd,GAAG,EAAE,kBAAkB,EAAE,GACxB,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhB;;;;;;OAMG;IACH,oBAAoB,CAAC,IAAI,QAAQ,CAAC;CACnC"}

package/dist/runner.js

@@ -0,0 +1 @@
+export {};

package/dist/sdk.d.ts

@@ -0,0 +1,44 @@
+import type { Address } from './base';
+/**
+ * SDK-related types
+ */
+/**
+ * Avatar row data from RPC
+ */
+export interface AvatarRow {
+    address: Address;
+    version: number;
+    type: string;
+    cidV0?: string;
+}
+/**
+ * Token balance row from RPC
+ */
+export interface TokenBalanceRow {
+    tokenAddress: Address;
+    balance: bigint;
+}
+/**
+ * Trust relation row from RPC
+ */
+export interface TrustRelationRow {
+    truster: Address;
+    trustee: Address;
+    expiryTime: number;
+}
+/**
+ * Circles query result with pagination
+ */
+export interface CirclesQuery<T> {
+    rows: T[];
+    hasMore: boolean;
+    nextPage(): Promise<CirclesQuery<T>>;
+}
+/**
+ * Group type enumeration
+ */
+export declare enum GroupType {
+    Standard = "Standard",
+    Custom = "Custom"
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAEhB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CAEjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB"}

package/dist/sdk.js

@@ -0,0 +1,8 @@
+/**
+ * Group type enumeration
+ */
+export var GroupType;
+(function (GroupType) {
+    GroupType["Standard"] = "Standard";
+    GroupType["Custom"] = "Custom";
+})(GroupType || (GroupType = {}));

package/dist/token.d.ts

@@ -0,0 +1,49 @@
+import type { Address } from './base';
+/**
+ * Token-related types
+ */
+/**
+ * Token balance information
+ */
+export interface TokenBalance {
+    tokenAddress: Address;
+    tokenId: bigint;
+    tokenOwner: Address;
+    tokenType: string;
+    version: number;
+    attoCircles: bigint;
+    circles: number;
+    staticAttoCircles: bigint;
+    staticCircles: number;
+    attoCrc: bigint;
+    crc: number;
+    isErc20: boolean;
+    isErc1155: boolean;
+    isWrapped: boolean;
+    isInflationary: boolean;
+    isGroup: boolean;
+}
+/**
+ * Token information
+ */
+export interface TokenInfo {
+    blockNumber: number;
+    timestamp: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash: string;
+    version: number;
+    type?: string;
+    tokenType: string;
+    token: Address;
+    tokenOwner: Address;
+}
+/**
+ * Token holder information from V_CrcV2_BalancesByAccountAndToken
+ */
+export interface TokenHolder {
+    account: Address;
+    tokenAddress: Address;
+    demurragedTotalBalance: string;
+}
+//# sourceMappingURL=token.d.ts.map

package/dist/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;CAChC"}

package/dist/token.js

@@ -0,0 +1 @@
+export {};

package/dist/transaction.d.ts

@@ -0,0 +1,34 @@
+import type { Address } from './base';
+/**
+ * Transaction history types
+ */
+/**
+ * Transaction history row (base data from RPC)
+ * Might include conversions between different circle representations
+ */
+export interface TransactionHistoryRow {
+    blockNumber: number;
+    timestamp: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash: string;
+    version: number;
+    from: Address;
+    to: Address;
+    id: string;
+    tokenAddress: Address;
+    value: string;
+    /** Human-readable circle amount (demurraged) */
+    circles?: number;
+    /** Atto-circles (demurraged, 18 decimals) */
+    attoCircles?: bigint;
+    /** Static circles (inflationary, human-readable) */
+    staticCircles?: number;
+    /** Atto-static circles (inflationary, 18 decimals) */
+    staticAttoCircles?: bigint;
+    /** Time Circles (CRC) human-readable */
+    crc?: number;
+    /** Atto-CRC (18 decimals) */
+    attoCrc?: bigint;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/transaction.js

@@ -0,0 +1 @@
+export {};

package/dist/trust.d.ts

@@ -0,0 +1,25 @@
+import type { Address, Hex } from './base';
+/**
+ * Trust relation types
+ */
+/**
+ * Trust relation information
+ */
+export interface TrustRelation {
+    blockNumber: number;
+    timestamp: number;
+    transactionIndex: number;
+    logIndex: number;
+    transactionHash: Hex;
+    truster: Address;
+    trustee: Address;
+    expiryTime: number;
+}
+export type TrustRelationType = 'trusts' | 'trustedBy' | 'mutuallyTrusts';
+export interface AggregatedTrustRelation {
+    subjectAvatar: Address;
+    relation: TrustRelationType;
+    objectAvatar: Address;
+    timestamp: number;
+}
+//# sourceMappingURL=trust.d.ts.map

package/dist/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../src/trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE3C;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,GAAG,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/trust.js

@@ -0,0 +1 @@
+export {};

package/dist/wrapper.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Wrapper and Circles types
+ */
+/**
+ * CirclesType enum
+ * Represents the type of Circles ERC20 wrapper
+ */
+export declare enum CirclesType {
+    Demurrage = 0,
+    Inflation = 1
+}
+/**
+ * Information about a wrapped token found in a transfer path
+ * Maps wrapper address to [amount used in path, wrapper type]
+ */
+export type WrappedTokenInfo = {
+    /** Amount of the wrapped token used in the path */
+    amount: bigint;
+    /** The type of wrapper (e.g., 'CrcV2_ERC20WrapperDeployed_Demurraged' or 'CrcV2_ERC20WrapperDeployed_Inflationary') */
+    tokenType: string;
+};
+/**
+ * Record of wrapped tokens found in a transfer path
+ * Maps wrapper address to wrapped token information
+ */
+export type WrappedTokensRecord = Record<string, WrappedTokenInfo>;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,oBAAY,WAAW;IACrB,SAAS,IAAI;IACb,SAAS,IAAI;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,uHAAuH;IACvH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/wrapper.js

@@ -0,0 +1,12 @@
+/**
+ * Wrapper and Circles types
+ */
+/**
+ * CirclesType enum
+ * Represents the type of Circles ERC20 wrapper
+ */
+export var CirclesType;
+(function (CirclesType) {
+    CirclesType[CirclesType["Demurrage"] = 0] = "Demurrage";
+    CirclesType[CirclesType["Inflation"] = 1] = "Inflation";
+})(CirclesType || (CirclesType = {}));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aboutcircles/sdk-types",
+  "version": "0.1.0",
+  "description": "TypeScript type definitions for Circles SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --format esm --splitting && tsc --emitDeclarationOnly",
+    "dev": "tsc --build --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "circles",
+    "types",
+    "typescript"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "abitype": "^1.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.4"
+  }
+}