@arcaresearch/sdk 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,1067 @@
+export type UserId = `usr_${string}`;
+export type RealmId = `rlm_${string}`;
+export type ApiKeyId = `key_${string}`;
+export type OrgId = `org_${string}`;
+export type OrgMemberId = `mem_${string}`;
+export type ObjectId = `obj_${string}`;
+export type OperationId = `op_${string}`;
+export type EventId = `evt_${string}`;
+export type DeltaId = `dlt_${string}`;
+export type BalanceId = `bal_${string}`;
+export type ReservedBalanceId = `rsv_${string}`;
+export type PositionId = `pos_${string}`;
+export type InvitationId = `inv_${string}`;
+export type ReconciliationId = `rec_${string}`;
+export type SimAccountId = `act_${string}`;
+export type SimPositionId = `sps_${string}`;
+export type SimOrderId = `ord_${string}`;
+export type SimFillId = `fil_${string}`;
+export type ErrorId = `err_${string}`;
+export type WatchId = `req_${string}`;
+/** Any TypeID-formatted identifier. */
+export type TypeId = `${string}_${string}`;
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        errorId?: ErrorId;
+    };
+}
+export type RealmType = 'demo' | 'production' | 'staging' | 'development' | 'testing';
+export interface RealmSettings {
+    /** Default builder fee in tenths of a basis point (e.g. 40 = 4.0 bps) */
+    defaultBuilderFeeBps?: number | null;
+}
+export interface Realm {
+    id: RealmId;
+    orgId: OrgId;
+    name: string;
+    slug: string;
+    type: RealmType;
+    description: string | null;
+    settings?: RealmSettings | null;
+    archivedAt?: string | null;
+    createdBy?: UserId | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RealmListResponse {
+    realms: Realm[];
+    total: number;
+}
+export type ArcaObjectType = 'denominated' | 'exchange' | 'deposit' | 'withdrawal' | 'escrow';
+export type ArcaObjectStatus = 'active' | 'deleting' | 'deleted';
+export interface ArcaObject {
+    id: ObjectId;
+    realmId: RealmId;
+    path: string;
+    type: ArcaObjectType;
+    denomination: string | null;
+    status: ArcaObjectStatus;
+    metadata: string | null;
+    deletedAt: string | null;
+    systemOwned: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ArcaObjectListResponse {
+    objects: ArcaObject[];
+    total: number;
+}
+export interface ArcaObjectBrowseResponse {
+    prefix: string;
+    folders: string[];
+    objects: ArcaObject[];
+}
+export interface CreateArcaObjectResponse {
+    object: ArcaObject;
+    operation: Operation;
+}
+export interface DeleteArcaObjectResponse {
+    object: ArcaObject;
+    operation: Operation;
+}
+export interface ArcaPositionCurrent {
+    id: PositionId;
+    realmId: RealmId;
+    arcaId: ObjectId;
+    market: string;
+    side: string;
+    size: string;
+    leverage: number;
+    entryPrice?: string | null;
+    updatedAt: string;
+}
+export interface ArcaObjectDetailResponse {
+    object: ArcaObject;
+    operations: Operation[];
+    events: ArcaEvent[];
+    deltas: StateDelta[];
+    balances: ArcaBalance[];
+    reservedBalances: ReservedBalance[];
+    positions: ArcaPositionCurrent[];
+}
+export type ReservedBalanceStatus = 'held' | 'released' | 'cancelled';
+export interface ReservedBalance {
+    id: ReservedBalanceId;
+    arcaId: ObjectId;
+    operationId: OperationId;
+    denomination: string;
+    amount: string;
+    status: ReservedBalanceStatus;
+    direction: 'inbound' | 'outbound';
+    sourceArcaPath?: string | null;
+    destinationArcaPath?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ArcaObjectVersionsResponse {
+    versions: ArcaObject[];
+}
+export type OperationType = 'transfer' | 'create' | 'delete' | 'deposit' | 'withdrawal' | 'swap' | 'order' | 'cancel' | 'fee_distribution';
+export type OperationState = 'pending' | 'completed' | 'failed' | 'expired';
+export interface Operation {
+    id: OperationId;
+    realmId: RealmId;
+    path: string;
+    type: OperationType;
+    state: OperationState;
+    sourceArcaPath: string | null;
+    targetArcaPath: string | null;
+    input: string | null;
+    outcome: string | null;
+    actorType: string | null;
+    actorId: UserId | null;
+    tokenJti: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface OperationListResponse {
+    operations: Operation[];
+    total: number;
+}
+export interface OperationDetailResponse {
+    operation: Operation;
+    events: ArcaEvent[];
+    deltas: StateDelta[];
+}
+export interface ArcaEvent {
+    id: EventId;
+    realmId: RealmId;
+    operationId: OperationId | null;
+    arcaPath: string | null;
+    type: string;
+    path: string | null;
+    payload: string | null;
+    createdAt: string;
+}
+export interface EventListResponse {
+    events: ArcaEvent[];
+    total: number;
+}
+export interface EventDetailResponse {
+    event: ArcaEvent;
+    operation: Operation | null;
+    deltas: StateDelta[];
+}
+export type DeltaType = 'balance_change' | 'settlement_change' | 'position_change' | 'status_change' | 'hold_change' | 'creation' | 'deletion';
+export interface StateDelta {
+    id: DeltaId;
+    realmId: RealmId;
+    eventId: EventId | null;
+    arcaPath: string;
+    deltaType: DeltaType;
+    beforeValue: string | null;
+    afterValue: string | null;
+    createdAt: string;
+}
+export interface StateDeltaListResponse {
+    deltas: StateDelta[];
+    total: number;
+}
+export interface ArcaBalance {
+    id: BalanceId;
+    arcaId: ObjectId;
+    denomination: string;
+    amount: string;
+}
+export interface ArcaBalanceListResponse {
+    balances: ArcaBalance[];
+}
+export interface InitiateDepositResponse {
+    operation: Operation;
+    /** Pool address for on-chain deposits (present when chain custody is active). */
+    poolAddress?: string;
+    /** Token contract address (e.g., USDC). */
+    tokenAddress?: string;
+    /** Chain identifier (e.g., "reth", "arbitrum"). */
+    chain?: string;
+    /** Intent expiration timestamp. */
+    expiresAt?: string;
+}
+export interface TransferResponse {
+    operation: Operation;
+}
+export interface NonceResponse {
+    nonce: number;
+    path: string;
+}
+export interface ExplorerSummary {
+    objectCount: number;
+    operationCount: number;
+    eventCount: number;
+    pendingOperationCount?: number;
+    expiredOperationCount?: number;
+}
+export interface CanonicalPosition {
+    id: PositionId;
+    realmId: RealmId;
+    arcaId: ObjectId;
+    market: string;
+    side: string;
+    size: string;
+    leverage: number;
+    updatedAt: string;
+}
+export interface SnapshotBalancesResponse {
+    realmId: string;
+    arcaId: string;
+    asOf: string;
+    balances: ArcaBalance[];
+    positions: CanonicalPosition[];
+}
+export interface AssetBreakdown {
+    asset: string;
+    category: 'spot' | 'perp' | 'exchange';
+    amount: string;
+    price: string | null;
+    valueUsd: string;
+    weightedAvgLeverage?: string | null;
+    avgEntryPrice?: string | null;
+}
+export interface BalanceValue {
+    denomination: string;
+    amount: string;
+    price: string | null;
+    valueUsd: string;
+}
+export interface PositionValue {
+    coin: string;
+    side: string;
+    size: string;
+    entryPrice: string;
+    markPrice: string | null;
+    unrealizedPnl: string;
+    valueUsd: string;
+}
+export interface ReservedValue {
+    denomination: string;
+    amount: string;
+    price: string | null;
+    valueUsd: string;
+    operationId: OperationId;
+    sourceArcaPath?: string | null;
+    destinationArcaPath?: string | null;
+    startedAt?: string | null;
+    inTransit?: boolean;
+}
+export interface ObjectValuation {
+    objectId: ObjectId;
+    path: string;
+    type: string;
+    denomination: string | null;
+    valueUsd: string;
+    balances: BalanceValue[];
+    reservedBalances: ReservedValue[];
+    pendingInbound?: ReservedValue[];
+    positions: PositionValue[] | null;
+}
+export interface PathAggregation {
+    prefix: string;
+    totalEquityUsd: string;
+    totalReservedUsd: string;
+    totalInTransitUsd?: string;
+    breakdown: AssetBreakdown[];
+    objects: ObjectValuation[];
+    asOf?: string;
+}
+export interface AggregationSourceDto {
+    type: 'prefix' | 'pattern' | 'paths' | 'watch';
+    value: string;
+}
+export interface CreateWatchResponse {
+    watchId: WatchId;
+    aggregation: PathAggregation;
+}
+export interface PnlResponse {
+    prefix: string;
+    from: string;
+    to: string;
+    startingEquityUsd: string;
+    endingEquityUsd: string;
+    netInflowsUsd: string;
+    netOutflowsUsd: string;
+    pnlUsd: string;
+    externalFlows: ExternalFlowEntry[];
+}
+export interface ExternalFlowEntry {
+    operationId: OperationId;
+    type: string;
+    direction: string;
+    amount: string;
+    denomination: string;
+    valueUsd: string;
+    sourceArcaPath: string | null;
+    targetArcaPath: string | null;
+    timestamp: string;
+}
+export interface EquityHistoryResponse {
+    prefix: string;
+    from: string;
+    to: string;
+    points: number;
+    equityPoints: EquityPoint[];
+}
+export interface EquityPoint {
+    timestamp: string;
+    equityUsd: string;
+}
+export interface EquityLookbackResponse {
+    range: string;
+    points: EquityPoint[];
+}
+export interface ReconciliationState {
+    id: ReconciliationId;
+    realmId: RealmId;
+    arcaId: ObjectId;
+    venue: string;
+    expectedBalanceUsd: string;
+    venueReportedUsd: string;
+    expectedPositionsJson: string | null;
+    venuePositionsJson: string | null;
+    lastSeenVenueHash: string | null;
+    driftDetectedAt: string | null;
+    lastReconciledAt: string | null;
+    updatedAt: string;
+}
+export interface ReconciliationStateListResponse {
+    items: ReconciliationState[];
+    total: number;
+}
+export interface BuilderProfile {
+    id: UserId;
+    email: string;
+    orgName: string;
+    orgId?: OrgId;
+    role?: OrgRole;
+    isPlatformAdmin?: boolean;
+}
+export type OrgRole = 'owner' | 'admin' | 'developer' | 'viewer';
+export type MemberType = 'user' | 'service_account';
+export type InvitationStatus = 'pending' | 'accepted' | 'expired' | 'revoked';
+export interface Organization {
+    id: OrgId;
+    name: string;
+    slug: string;
+    createdBy: UserId;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MyOrgMembership {
+    orgId: OrgId;
+    orgName: string;
+    orgSlug: string;
+    role: OrgRole;
+    realmTypeScope?: RealmType[];
+}
+export interface OrgMember {
+    id: OrgMemberId;
+    orgId: OrgId;
+    userId: UserId;
+    email?: string;
+    memberType: MemberType;
+    role: OrgRole;
+    realmTypeScope?: RealmType[];
+    invitedBy?: string;
+    createdAt: string;
+}
+export interface OrgMemberListResponse {
+    members: OrgMember[];
+    total: number;
+}
+export interface Invitation {
+    id: InvitationId;
+    orgId: OrgId;
+    orgName?: string;
+    email: string;
+    role: OrgRole;
+    realmTypeScope?: RealmType[];
+    status: InvitationStatus;
+    expiresAt: string;
+    invitedBy: UserId;
+    inviteLink?: string;
+    createdAt: string;
+}
+export interface InvitationListResponse {
+    invitations: Invitation[];
+    total: number;
+}
+export interface InvitationPreview {
+    orgName: string;
+    email: string;
+    role: OrgRole;
+    status: InvitationStatus;
+    expiresAt: string;
+}
+export interface InviteMemberRequest {
+    email: string;
+    role: OrgRole;
+    realmTypeScope?: RealmType[];
+}
+export interface UpdateMemberRequest {
+    role?: OrgRole;
+    realmTypeScope?: RealmType[];
+}
+export interface AuthResponse {
+    token: string;
+    refreshToken?: string;
+    expiresAt: string;
+    builder: BuilderProfile;
+}
+export interface RefreshResponse {
+    token: string;
+    refreshToken: string;
+    expiresAt: string;
+}
+export type ApiKeyStatus = 'active' | 'revoked';
+export interface ApiKey {
+    id: ApiKeyId;
+    builderId: UserId;
+    name: string;
+    keyPrefix: string;
+    status: ApiKeyStatus;
+    createdAt: string;
+    revokedAt: string | null;
+    updatedAt: string;
+}
+export interface ApiKeyCreatedResponse {
+    apiKey: ApiKey;
+    rawKey: string;
+}
+export interface ApiKeyListResponse {
+    apiKeys: ApiKey[];
+    total: number;
+}
+export interface BrowseObjectsOptions {
+    prefix?: string;
+    includeDeleted?: boolean;
+}
+/** Effect of a policy statement. */
+export type PolicyEffect = 'Allow' | 'Deny';
+/**
+ * A single policy statement with an effect, actions, and resource patterns.
+ * Used in scoped tokens and scoped API keys.
+ *
+ * - `Allow` (default) grants the listed actions on the listed resources.
+ * - `Deny` explicitly blocks them, **overriding any Allow statements**.
+ *
+ * @example
+ * ```ts
+ * // Allow transfers within a user's subtree
+ * const allow: PolicyStatement = {
+ *   effect: 'Allow',
+ *   actions: ['arca:TransferFrom', 'arca:ReceiveTo'],
+ *   resources: ['/users/u123/*'],
+ * };
+ *
+ * // Safety rail: deny everything on internal paths
+ * const deny: PolicyStatement = {
+ *   effect: 'Deny',
+ *   actions: ['arca:*'],
+ *   resources: ['/_internal/*'],
+ * };
+ * ```
+ */
+export interface PolicyStatement {
+    /** 'Allow' (default) or 'Deny'. Deny always overrides Allow. */
+    effect?: PolicyEffect;
+    /** Actions to grant or deny (e.g. 'arca:TransferFrom', 'arca:Read', 'arca:*') */
+    actions: string[];
+    /** Resource path patterns (e.g. '/users/*', '*') */
+    resources: string[];
+}
+/**
+ * IAM-style scope containing policy statements.
+ * Each statement grants a set of actions on a set of resources.
+ * Default: read-only on all resources.
+ */
+export interface TokenScope {
+    statements: PolicyStatement[];
+}
+/** Entry in the action catalog returned by GET /api/v1/permissions */
+export interface ActionCatalogEntry {
+    action: string;
+    description: string;
+    category: string;
+}
+/** Alias entry in the action catalog */
+export interface AliasCatalogEntry {
+    alias: string;
+    expandsTo: string[];
+}
+/** Response from GET /api/v1/permissions */
+export interface PermissionCatalogResponse {
+    actions: ActionCatalogEntry[];
+    aliases: AliasCatalogEntry[];
+}
+export interface InvariantViolation {
+    entityId: string | null;
+    message: string;
+}
+export interface InvariantCheckResult {
+    id: string;
+    passed: boolean;
+    violationCount: number;
+    violations: InvariantViolation[];
+}
+export interface InvariantCheckResponse {
+    allPassed: boolean;
+    results: InvariantCheckResult[];
+}
+/** Configuration using an API key (backend/programmatic use). */
+export interface ArcaApiKeyConfig {
+    /** API key (format: arca_<prefix>_<secret>) */
+    apiKey: string;
+    /** Realm slug or UUID */
+    realm: string;
+    /** Base URL of the Arca API. Defaults to https://api.arcaos.io */
+    baseUrl?: string;
+}
+/** Configuration using a scoped token (frontend/end-user use). */
+export interface ArcaTokenConfig {
+    /** Scoped JWT token issued by the builder's backend via POST /auth/token */
+    token: string;
+    /** Realm slug, UUID, or omit to use the realm embedded in the token */
+    realm?: string;
+    /** Base URL of the Arca API. Defaults to https://api.arcaos.io */
+    baseUrl?: string;
+}
+/** SDK configuration — pass either an API key or a scoped token. */
+export type ArcaConfig = ArcaApiKeyConfig | ArcaTokenConfig;
+export interface CreateDenominatedArcaOptions {
+    /** Full Arca path (e.g. /users/u123/usd/main) */
+    ref: string;
+    /** Denomination (e.g. USD, BTC) */
+    denomination: string;
+    /** Optional metadata */
+    metadata?: string;
+    /** Optional operation path (idempotency key). Use nonce API with separator ":" to generate. */
+    operationPath?: string;
+}
+/** @deprecated Use CreateDenominatedArcaOptions instead */
+export type EnsureDenominatedArcaOptions = CreateDenominatedArcaOptions;
+export interface CreateArcaOptions {
+    /** Full Arca path */
+    ref: string;
+    /** Arca object type */
+    type: 'denominated' | 'exchange' | 'deposit' | 'withdrawal' | 'escrow';
+    /** Denomination (required for denominated type) */
+    denomination?: string;
+    /** Optional metadata */
+    metadata?: string;
+    /** Optional operation path (idempotency key). Use nonce API with separator ":" to generate. */
+    operationPath?: string;
+}
+export interface EnsureDeletedOptions {
+    /** Full Arca path to delete */
+    ref: string;
+    /** Optional path of the Arca to sweep remaining funds into */
+    sweepTo?: string;
+    /** Liquidate all exchange positions before deletion (exchange objects only) */
+    liquidatePositions?: boolean;
+    /** Operation path (idempotency key). Auto-generated if not provided. */
+    operationPath?: string;
+}
+export interface TransferOptions {
+    /** Operation path (idempotency key) */
+    path: string;
+    /** Source Arca path */
+    from: string;
+    /** Target Arca path */
+    to: string;
+    /** Amount as decimal string */
+    amount: string;
+}
+export interface DepositOptions {
+    /** Target Arca path */
+    arcaRef: string;
+    /** Amount as decimal string */
+    amount: string;
+    /** Operation path for idempotency. If provided, duplicate calls return the existing operation. */
+    path?: string;
+    /** Sender wallet address (optional, used for on-chain deposit matching). */
+    senderAddress?: string;
+}
+export interface WithdrawalOptions {
+    /** Source Arca path to withdraw from */
+    arcaPath: string;
+    /** Amount as decimal string */
+    amount: string;
+    /** Destination on-chain address. If omitted, tokens are burned (demo/sim mode). */
+    destinationAddress?: string;
+    /** Operation path for idempotency */
+    path?: string;
+}
+export interface InitiateWithdrawalResponse {
+    operation: Operation;
+    txHash?: string;
+}
+export interface ListObjectsOptions {
+    /** Path prefix to filter */
+    prefix?: string;
+    /** Include deleted objects */
+    includeDeleted?: boolean;
+}
+export interface ListOperationsOptions {
+    /** Filter by operation type */
+    type?: OperationType;
+    /** Filter by source or target arca path */
+    arcaPath?: string;
+    /** Filter by operation path prefix */
+    path?: string;
+}
+export interface ListEventsOptions {
+    /** Filter by arca path */
+    arcaPath?: string;
+    /** Filter by event path prefix */
+    path?: string;
+}
+export type EventConnectionStatus = 'connecting' | 'connected' | 'disconnected';
+/** All event types emitted by the Arca WebSocket stream. */
+export declare const EventType: {
+    readonly OperationCreated: "operation.created";
+    readonly OperationUpdated: "operation.updated";
+    readonly EventCreated: "event.created";
+    readonly ObjectCreated: "object.created";
+    readonly ObjectUpdated: "object.updated";
+    readonly ObjectDeleted: "object.deleted";
+    readonly BalanceUpdated: "balance.updated";
+    readonly ExchangeUpdated: "exchange.updated";
+    readonly AggregationUpdated: "aggregation.updated";
+    readonly MidsUpdated: "mids.updated";
+    readonly RealmCreated: "realm.created";
+    readonly AgentText: "agent.text";
+    readonly AgentToolUse: "agent.tool_use";
+    readonly AgentPlan: "agent.plan";
+    readonly AgentConversationLog: "agent.conversation_log";
+    readonly AgentDone: "agent.done";
+    readonly AgentStepUpdated: "agent.step_updated";
+    readonly AgentExecutionDone: "agent.execution_done";
+};
+export type EventType = (typeof EventType)[keyof typeof EventType];
+/** Channel groups for WebSocket subscriptions. */
+export declare const Channel: {
+    readonly Operations: "operations";
+    readonly Balances: "balances";
+    readonly Exchange: "exchange";
+    readonly Objects: "objects";
+    readonly Events: "events";
+    readonly Aggregation: "aggregation";
+    readonly Agent: "agent";
+};
+export type Channel = (typeof Channel)[keyof typeof Channel];
+interface BaseRealmEvent {
+    realmId: string;
+    entityId: string;
+    entityPath: string;
+    summary?: ExplorerSummary;
+}
+export interface OperationCreatedEvent extends BaseRealmEvent {
+    type: typeof EventType.OperationCreated;
+    operation: Operation;
+}
+export interface OperationUpdatedEvent extends BaseRealmEvent {
+    type: typeof EventType.OperationUpdated;
+    operation: Operation;
+}
+export interface EventCreatedEvent extends BaseRealmEvent {
+    type: typeof EventType.EventCreated;
+    event: ArcaEvent;
+}
+export interface ObjectCreatedEvent extends BaseRealmEvent {
+    type: typeof EventType.ObjectCreated;
+    object?: ArcaObject;
+}
+export interface ObjectUpdatedEvent extends BaseRealmEvent {
+    type: typeof EventType.ObjectUpdated;
+    object?: ArcaObject;
+}
+export interface ObjectDeletedEvent extends BaseRealmEvent {
+    type: typeof EventType.ObjectDeleted;
+}
+export interface BalanceUpdatedEvent extends BaseRealmEvent {
+    type: typeof EventType.BalanceUpdated;
+}
+export interface ExchangeUpdatedEvent extends BaseRealmEvent {
+    type: typeof EventType.ExchangeUpdated;
+    exchangeState: ExchangeState;
+}
+export interface AggregationUpdatedEvent extends BaseRealmEvent {
+    type: typeof EventType.AggregationUpdated;
+    aggregation?: PathAggregation;
+}
+export interface MidsUpdatedEvent {
+    type: typeof EventType.MidsUpdated;
+    mids: Record<string, string>;
+}
+export interface RealmCreatedEvent {
+    type: typeof EventType.RealmCreated;
+    realm: Realm;
+}
+export interface AgentTextEvent {
+    type: typeof EventType.AgentText;
+    chatId: string;
+    content: string;
+}
+export interface AgentToolUseEvent {
+    type: typeof EventType.AgentToolUse;
+    chatId: string;
+    tool: string;
+    input: Record<string, unknown>;
+}
+export interface AgentPlanEvent {
+    type: typeof EventType.AgentPlan;
+    chatId: string;
+    summary: string;
+    steps: AgentPlanStep[];
+}
+export interface AgentPlanStep {
+    id: string;
+    description: string;
+    operation: string;
+    params: Record<string, unknown>;
+    dependsOn?: string[];
+}
+export interface AgentConversationLogEvent {
+    type: typeof EventType.AgentConversationLog;
+    chatId: string;
+    log: Record<string, unknown>;
+}
+export interface AgentDoneEvent {
+    type: typeof EventType.AgentDone;
+    chatId: string;
+}
+export interface AgentStepUpdatedEvent {
+    type: typeof EventType.AgentStepUpdated;
+    chatId: string;
+    stepId: string;
+    status: string;
+    error?: string;
+    operationId?: string;
+    resolvedSize?: string;
+}
+export interface AgentExecutionDoneEvent {
+    type: typeof EventType.AgentExecutionDone;
+    chatId: string;
+}
+export type AgentEvent = AgentTextEvent | AgentToolUseEvent | AgentPlanEvent | AgentConversationLogEvent | AgentDoneEvent | AgentStepUpdatedEvent | AgentExecutionDoneEvent;
+export type TypedRealmEvent = OperationCreatedEvent | OperationUpdatedEvent | EventCreatedEvent | ObjectCreatedEvent | ObjectUpdatedEvent | ObjectDeletedEvent | BalanceUpdatedEvent | ExchangeUpdatedEvent | AggregationUpdatedEvent | MidsUpdatedEvent | RealmCreatedEvent;
+export interface EventSubscriptionOptions {
+    /** Optional path prefix to filter events client-side */
+    prefix?: string;
+    /** Called when connection status changes */
+    onStatus?: (status: EventConnectionStatus) => void;
+}
+/** Realm event from the WebSocket stream (untyped union -- prefer TypedRealmEvent). */
+export interface RealmEvent {
+    realmId: string;
+    type: string;
+    entityId: string;
+    entityPath: string;
+    aggregation?: PathAggregation | Record<string, unknown>;
+    summary?: ExplorerSummary | Record<string, unknown>;
+    operation?: Operation;
+    event?: ArcaEvent;
+    object?: ArcaObject;
+    mids?: Record<string, string>;
+    exchangeState?: ExchangeState;
+    realm?: Realm;
+    coin?: string;
+    interval?: CandleInterval;
+    candle?: Candle;
+}
+export type EventCallback = (event: RealmEvent) => void;
+export interface EventSubscription {
+    close(): void;
+}
+export interface CreatePerpsExchangeOptions {
+    /** Full Arca path (e.g. /exchanges/hl1) */
+    ref: string;
+    /** Exchange provider. Currently only 'hyperliquid'. */
+    exchangeType?: 'hyperliquid';
+    /** Optional operation path (idempotency key) */
+    operationPath?: string;
+}
+export interface FeeTarget {
+    /** Path of the Arca to receive a share of the builder fee */
+    arcaPath: string;
+    /** Percentage of the distributable fee (1-100, must sum to <= 100) */
+    percentage: number;
+}
+export interface PlaceOrderOptions {
+    /** Operation path (idempotency key) */
+    path: string;
+    /** Exchange Arca object ID */
+    objectId: string;
+    /** Coin/asset to trade (e.g. BTC, ETH) */
+    coin: string;
+    /** Order side */
+    side: 'BUY' | 'SELL';
+    /** Order type */
+    orderType: 'MARKET' | 'LIMIT';
+    /** Order size as decimal string */
+    size: string;
+    /** Size denomination: 'token' (default) or 'usd' */
+    szDenom?: 'token' | 'usd';
+    /** Limit price (required for LIMIT orders) */
+    price?: string;
+    /** Leverage multiplier (default: 1) */
+    leverage?: number;
+    /** If true, only reduces an existing position */
+    reduceOnly?: boolean;
+    /** Time in force (default: GTC) */
+    timeInForce?: 'GTC' | 'IOC' | 'ALO';
+    /** Builder fee in tenths of a basis point (e.g. 45 = 4.5 bps). Additive to base exchange fee. */
+    builderFeeBps?: number;
+    /** Fee routing targets. Percentage-based splits of the distributable builder fee. */
+    feeTargets?: FeeTarget[];
+}
+export interface CancelOrderOptions {
+    /** Operation path (idempotency key) */
+    path: string;
+    /** Exchange Arca object ID */
+    objectId: string;
+    /** ID of the order to cancel */
+    orderId: string;
+}
+export interface OrderOperationResponse {
+    operation: Operation;
+}
+export interface SimAccount {
+    id: SimAccountId;
+    realmId: RealmId;
+    name: string;
+    usdBalance: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SimMarginSummary {
+    accountValue: string;
+    totalNtlPos: string;
+    totalMarginUsed: string;
+    withdrawable: string;
+    totalUnrealizedPnl: string;
+    totalRawUsd?: string;
+}
+export interface SimPosition {
+    id: SimPositionId;
+    accountId: SimAccountId;
+    realmId: RealmId;
+    coin: string;
+    side: string;
+    size: string;
+    entryPrice: string;
+    leverage: number;
+    marginUsed: string;
+    liquidationPrice: string | null;
+    unrealizedPnl: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SimOrder {
+    id: SimOrderId;
+    accountId: SimAccountId;
+    realmId: RealmId;
+    coin: string;
+    side: string;
+    orderType: string;
+    price: string | null;
+    size: string;
+    filledSize: string;
+    avgFillPrice: string | null;
+    status: string;
+    reduceOnly: boolean;
+    timeInForce: string;
+    leverage: number;
+    /** Builder fee in tenths of a basis point (e.g. 45 = 4.5 bps) */
+    builderFeeBps?: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SimFill {
+    id: SimFillId;
+    orderId: SimOrderId;
+    accountId: SimAccountId;
+    realmId: RealmId;
+    coin: string;
+    side: string;
+    price: string;
+    size: string;
+    fee: string;
+    builderFee?: string;
+    realizedPnl: string | null;
+    isLiquidation: boolean;
+    createdAt: string;
+}
+export interface SimFeeTierEntry {
+    tier: number;
+    label: string;
+    minVolume14d: number;
+    takerBps: number;
+    makerBps: number;
+}
+export interface SimFeeRates {
+    taker: string;
+    maker: string;
+    platformFee?: string;
+    tier?: number;
+    tierLabel?: string;
+    volume14d?: string;
+    schedule?: SimFeeTierEntry[];
+}
+export interface ExchangeState {
+    account: SimAccount;
+    marginSummary: SimMarginSummary;
+    positions: SimPosition[];
+    openOrders: SimOrder[];
+    feeRates?: SimFeeRates | null;
+}
+export interface SimOrderWithFills {
+    order: SimOrder;
+    fills: SimFill[];
+}
+export interface ActiveAssetData {
+    /** Coin/asset (e.g. BTC, ETH) */
+    coin: string;
+    /** Current leverage setting */
+    leverage: {
+        type: string;
+        value: number;
+    };
+    /** Max trade sizes in tokens: [max sell (negative), max buy (positive)] */
+    maxTradeSzs: [string, string];
+    /** Max trade sizes in USD: [sell USD, buy USD] */
+    availableToTrade: [string, string];
+    /** Current mark price */
+    markPx: string;
+    /** Effective fee rate as a decimal */
+    feeRate: string;
+}
+export interface UpdateLeverageOptions {
+    /** Exchange Arca object ID */
+    objectId: string;
+    /** Coin/asset to set leverage for (e.g. BTC, ETH) */
+    coin: string;
+    /** Leverage multiplier (1 to maxLeverage for the asset) */
+    leverage: number;
+}
+export interface UpdateLeverageResponse {
+    accountId: string;
+    coin: string;
+    leverage: number;
+    previousLeverage: number;
+}
+export interface LeverageSetting {
+    coin: string;
+    leverage: number;
+}
+export interface SimMetaAsset {
+    name: string;
+    index: number;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated: boolean;
+}
+export interface SimMetaResponse {
+    universe: SimMetaAsset[];
+}
+export interface SimMidsResponse {
+    mids: Record<string, string>;
+}
+export interface SimBookLevel {
+    price: string;
+    size: string;
+    orderCount: number;
+}
+export interface SimBookResponse {
+    coin: string;
+    bids: SimBookLevel[];
+    asks: SimBookLevel[];
+    time: number;
+}
+export type CandleInterval = '1m' | '5m' | '15m' | '1h' | '4h' | '1d';
+export interface Candle {
+    t: number;
+    o: string;
+    h: string;
+    l: string;
+    c: string;
+    v: string;
+    n: number;
+}
+export interface CandlesResponse {
+    coin: string;
+    interval: string;
+    candles: Candle[];
+}
+export interface CandleEvent {
+    coin: string;
+    interval: CandleInterval;
+    candle: Candle;
+}
+export type AuthAuditEventType = 'sign_in' | 'token_minted' | 'api_key_authenticated' | 'permission_denied';
+export interface AuthAuditEntry {
+    id: TypeId;
+    builderId: UserId;
+    eventType: AuthAuditEventType;
+    actorType: string;
+    actorId: UserId;
+    realmId: RealmId | null;
+    subject: string | null;
+    action: string | null;
+    resource: string | null;
+    scopeSummary: string | null;
+    ipAddress: string | null;
+    tokenJti: string | null;
+    expiresAt: string | null;
+    success: boolean;
+    errorMessage: string | null;
+    operationCount?: number;
+    createdAt: string;
+}
+export interface AuthAuditListResponse {
+    entries: AuthAuditEntry[];
+    total: number;
+}
+export interface AuthAuditFilters {
+    eventType?: AuthAuditEventType;
+    realmId?: string;
+    since?: string;
+    until?: string;
+    success?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface CredentialScopeResponse {
+    credentialType: 'scoped_token' | 'api_key' | 'builder';
+    credentialId: string;
+    subject: string | null;
+    scope: string | null;
+    fullAccess: boolean;
+    createdAt: string | null;
+    expiresAt: string | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map