@berachain/berajs 0.2.11 → 0.2.13

package/dist/enum/slippage.d.ts

@@ -0,0 +1,17 @@
+export declare const DEFAULT_SLIPPAGE: 0.5;
+export declare const SLIPPAGE_DEGEN_VALUE: 25;
+/**
+ * Default
+ */
+export declare const DEFAULT_DEADLINE: 60;
+export declare enum SLIPPAGE_MODE {
+    AUTO = "auto",
+    CUSTOM = "custom",
+    DEGEN = "degen"
+}
+export declare enum TRANSACTION_MODE {
+    AUTO = "auto",
+    CUSTOM = "custom",
+    INFINITY = "infinity"
+}
+//# sourceMappingURL=slippage.d.ts.map

package/dist/enum/slippage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slippage.d.ts","sourceRoot":"","sources":["../../src/enum/slippage.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,KAAe,CAAC;AAC7C,eAAO,MAAM,oBAAoB,IAAc,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,gBAAgB,IAAc,CAAC;AAE5C,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,oBAAY,gBAAgB;IAC1B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB"}

package/dist/enum/txnEnum.d.ts

@@ -0,0 +1,90 @@
+export declare enum TransactionActionType {
+    /**
+     * Used for testing purposes.
+     */
+    TEST = "Test",
+    SEND = "Send tokens",
+    APPROVAL = "Approval",
+    SWAP = "Swap",
+    WRAP = "Wrap",
+    UNWRAP = "Unwrap",
+    CREATE_POOL = "Create Pool",
+    ADD_LIQUIDITY = "Add Liquidity",
+    WITHDRAW_LIQUIDITY = "Withdraw Liquidity",
+    DELEGATE = "Delegate",
+    REDELEGATE = "Redelegate",
+    QUEUE_BOOST = "Queue Boost",
+    ACTIVATE_BOOST = "Activate Boost",
+    QUEUE_UNBOOSTING_ALL = "Queue Drop Boost All",
+    UNBOOST = "Drop Boost",
+    QUEUE_UNBOOST = "Queue Drop Boost",
+    CANCEL_UNBOOST = "Cancel Drop Boost",
+    CANCEL_BOOST = "Cancel Boost",
+    UNBONDING = "Unbonding",
+    CANCEL_UNBONDING = "Cancel Unbonding",
+    SUBMIT_PROPOSAL = "Submit Proposal",
+    CANCEL_PROPOSAL = "Cancel Proposal",
+    EXECUTE_PROPOSAL = "Execute Proposal",
+    QUEUE_PROPOSAL = "Queue Proposal",
+    VOTE = "Vote",
+    MODIFY_REWARD_DURATION = "Change Reward Duration",
+    MODIFY_REWARD_RATE = "Change Reward Rate",
+    RESET_REWARD_MODE = "Reset Reward Mode",
+    CREATE_BRIBE = "Add Incentives",
+    CLAIMING_BRIBES = "Claiming Incentives",// claiming others
+    CLAIMING_REWARDS = "Claiming BGT",
+    CLAIM_ALL_REWARDS = "Claim All Rewards",
+    RECOVER_FUNDS = "Recover Bex Funds",
+    REDEEM_BGT = "Redeem BGT",
+    MINT_HONEY = "Mint Honey",
+    REDEEM_HONEY = "Redeem Honey",
+    SUPPLY = "Supply",
+    WITHDRAW = "Withdraw",
+    BORROW = "Borrow",
+    REPAY = "Repay",
+    STAKE = "Stake",
+    UNSTAKE = "Unstake",
+    ENSO_ROUTE = "Enso Route",
+    MARKET_LONG = "Market Long",
+    MARKET_SHORT = "Market Short",
+    LIMIT_LONG = "Limit Long",
+    LIMIT_SHORT = "Limit Short",
+    CANCEL_ORDER = "Cancel Order",
+    CANCEL_ALL_ORDERS = "Cancel All Orders",
+    EDIT_PERPS_ORDER = "Edit Perps Order",
+    DEPOSIT_HONEY = "Deposit Honey",
+    START_WITHDRAW_REQUEST = "Start Withdraw Request",
+    CANCEL_WITHDRAW_REQUEST = "Cancel Withdraw Request",
+    WITHDRAW_HONEY = "Withdraw Honey",
+    DELEGATE_OCT = "Delegate",
+    REVOKE_OCT = "Revoke",
+    REFER = "Refer",
+    CREATE_REWARDS_VAULT = "Create Reward Vault",
+    APPLYING_REWARD_ALLOCATION = "Apply Reward Allocation",
+    APPLYING_OPERATOR_CHANGE = "Apply Operator Change",
+    CANCELING_OPERATOR_CHANGE = "Cancel Operator Change",
+    REQUEST_OPERATOR_CHANGE = "Request Operator Change",
+    APPLYING_REWARD_ALLOCATOR_CHANGE = "Apply Reward Allocator Change",
+    APPLYING_COMMISSION_CHANGE = "Apply Commission Change",
+    BONDING_BERA = "Stake BERA",
+    ZAP_STAKE_BERA = "Zap Stake BERA",
+    UNBONDING_BERA = "Unstake BERA",
+    QUEUE_UNBONDING_BERA = "Queue Unstake BERA",
+    BEND_MARKET_REPAY_AND_WITHDRAW_COLLATERAL = "Bend Market Repay and Withdraw Collateral",
+    BEND_MARKET_SUPPLY_COLLATERAL_AND_BORROW = "Bend Market Supply Collateral and Borrow",
+    BEND_MARKET_MULTIPLY = "Bend Market Multiply",
+    BEND_MARKET_DEMULTIPLY = "Bend Market Demultiply",
+    BEND_VAULT_SUPPLY = "Bend Vault Supply",
+    BEND_VAULT_WITHDRAW = "Bend Vault Withdraw",
+    BEND_CURATOR_REALLOCATE = "Bend Curator Reallocate",
+    BEND_CURATOR_UPDATE_MARKET_SUPPLY_CAP = "Bend Curator Update Market Supply Cap",
+    BEND_CURATOR_REVOKE_PENDING_SUPPLY_CAP = "Bend Curator Revoke Pending Supply Cap",
+    BEND_CURATOR_ACCEPT_PENDING_SUPPLY_CAP = "Bend Curator Accept Pending Supply Cap",
+    BEND_CURATOR_UPDATE_SUPPLY_QUEUE = "Bend Curator Update Supply Queue",
+    BEND_CURATOR_UPDATE_WITHDRAW_QUEUE = "Bend Curator Update Withdraw Queue",
+    BEND_CURATOR_TRANSFER_OWNER = "Bend Curator Transfer Owner",
+    BEND_CURATOR_CHANGE_GUARDIAN = "Bend Curator Change Guardian",
+    BEND_CURATOR_SET_CURATOR = "Bend Curator Set Curator",
+    BEND_CURATOR_SET_ALLOCATOR = "Bend Curator Set Allocator"
+}
+//# sourceMappingURL=txnEnum.d.ts.map

package/dist/enum/txnEnum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txnEnum.d.ts","sourceRoot":"","sources":["../../src/enum/txnEnum.ts"],"names":[],"mappings":"AAAA,oBAAY,qBAAqB;IAC/B;;OAEG;IACH,IAAI,SAAS;IAGb,IAAI,gBAAgB;IAEpB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;IAEjB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IAEzC,QAAQ,aAAa;IACrB,UAAU,eAAe;IAEzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,oBAAoB,yBAAyB;IAC7C,OAAO,eAAe;IACtB,aAAa,qBAAqB;IAClC,cAAc,sBAAsB;IACpC,YAAY,iBAAiB;IAE7B,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;IAErC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,IAAI,SAAS;IAEb,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,YAAY,mBAAmB;IAC/B,eAAe,wBAAwB,CAAE,kBAAkB;IAC3D,gBAAgB,iBAAiB;IACjC,iBAAiB,sBAAsB;IAEvC,aAAa,sBAAsB;IAEnC,UAAU,eAAe;IAEzB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAE7B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IAEf,KAAK,UAAU;IACf,OAAO,YAAY;IAEnB,UAAU,eAAe;IAGzB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IACnD,cAAc,mBAAmB;IACjC,YAAY,aAAa;IACzB,UAAU,WAAW;IACrB,KAAK,UAAU;IAGf,oBAAoB,wBAAwB;IAC5C,0BAA0B,4BAA4B;IACtD,wBAAwB,0BAA0B;IAClD,yBAAyB,2BAA2B;IACpD,uBAAuB,4BAA4B;IACnD,gCAAgC,kCAAkC;IAClE,0BAA0B,4BAA4B;IAEtD,YAAY,eAAe;IAC3B,cAAc,mBAAmB;IACjC,cAAc,iBAAiB;IAC/B,oBAAoB,uBAAuB;IAG3C,yCAAyC,8CAA8C;IACvF,wCAAwC,6CAA6C;IACrF,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAG3C,uBAAuB,4BAA4B;IACnD,qCAAqC,0CAA0C;IAC/E,sCAAsC,2CAA2C;IACjF,sCAAsC,2CAA2C;IACjF,gCAAgC,qCAAqC;IACrE,kCAAkC,uCAAuC;IACzE,2BAA2B,gCAAgC;IAC3D,4BAA4B,iCAAiC;IAC7D,wBAAwB,6BAA6B;IACrD,0BAA0B,+BAA+B;CAC1D"}

package/dist/errors/BeraError.d.ts

@@ -0,0 +1,99 @@
+import { type Abi } from "viem";
+import type { SeverityLevel } from "./severity";
+import { type SpanStatusType } from "./spanStatus";
+export interface IBeraErrorArgs {
+    message?: string;
+    displayMessage?: string;
+    cause?: unknown;
+    reason?: string;
+    chainId?: number;
+    fingerprint?: string[];
+    /**
+     * The level of the error to be used for error reporting.
+     */
+    level?: SeverityLevel;
+    tags?: {
+        [key in TagsKey]?: Primitive;
+    };
+    extra?: Record<string, unknown>;
+    /**
+     * Optional ABI to be used to parse the error.
+     */
+    abi?: Abi;
+    /**
+     * Span status for tracing. When set, the tracing adapter uses this to
+     * set the span status instead of a generic "internal_error".
+     * Auto-inferred from `reason` when not explicitly provided.
+     */
+    spanStatus?: SpanStatusType;
+}
+type Primitive = number | string | boolean | bigint | symbol | null | undefined;
+/**
+ * An helper type to make sure we only use the allowed tags. Sync this with docs/errors.md
+ */
+type TagsKey = "wallet.chain" | "wallet.connector" | "wallet.address" | "error.reason" | "operation.type" | "operation.key" | "operation.txn.functionName" | "operation.txn.to" | "operation.txn.status" | "operation.source.url" | "operation.source.name" | "operation.source.queryName" | "operation.source.type";
+/**
+ * Base error class for the entire berajs SDK.
+ *
+ * All errors should be a BeraError or one of its subclasses. Unknown errors should be
+ * normalized via `initBeraError({ cause })`.
+ *
+ * Key design: the constructor runs an **automatic reason detection pipeline** when `reason`
+ * is not explicitly provided. It calls `parseViemError` on the `cause` to extract a
+ * machine-readable reason code (e.g. "NotEnoughBalance", "BAL#508", "UserRejectedRequestError").
+ * That reason is then matched against `errorMap.ts` to resolve a user-friendly `displayMessage`.
+ *
+ * This means: for most viem errors, you only need to pass `cause` and everything else
+ * (reason, displayMessage, level) is derived automatically.
+ *
+ * @see parseViemError — the reason extraction engine
+ * @see errorMap.ts — reason → displayMessage mapping
+ * @see initBeraError — normalizes any error into a BeraError (preferred entry point)
+ */
+export declare class BeraError extends Error {
+    /**
+     * A human-readable message that can be displayed to end user.
+     *
+     * In berachain dapps, this is shown in the error pop-up.
+     */
+    displayMessage: string;
+    /**
+     * The cause of the error.
+     *
+     * This is typically the error that was thrown.
+     */
+    cause: unknown;
+    /**
+     * The chain id of the error.
+     */
+    chainId?: number;
+    /**
+     * The code for the reason for the error.
+     *
+     * This is typically the error code can be found in the errorMap.ts file. I.e. NotEnoughBalance or BAL#508
+     */
+    reason: string | null;
+    /**
+     * The fingerprint for the error.
+     *
+     * This is typically used to group errors in Sentry.
+     */
+    fingerprint: string[] | undefined;
+    private _tags;
+    set tags(tags: {
+        [key: string | TagsKey]: Primitive;
+    });
+    get tags(): {
+        [key: string | TagsKey]: Primitive;
+    };
+    level: SeverityLevel;
+    /**
+     * Span status for tracing providers.
+     * Auto-inferred from `reason` when not explicitly provided.
+     */
+    spanStatus?: SpanStatusType;
+    extra: Record<string, unknown>;
+    constructor({ message: m, displayMessage: dm, cause, reason, level, abi, tags, chainId, fingerprint, spanStatus, }: IBeraErrorArgs);
+}
+export {};
+//# sourceMappingURL=BeraError.d.ts.map

package/dist/errors/BeraError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeraError.d.ts","sourceRoot":"","sources":["../../src/errors/BeraError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAa,MAAM,MAAM,CAAC;AAO3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE;SACJ,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,SAAS;KAC7B,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AA2BhF;;GAEG;AACH,KAAK,OAAO,GACR,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,4BAA4B,GAC5B,kBAAkB,GAClB,sBAAsB,GACtB,sBAAsB,GACtB,uBAAuB,GACvB,4BAA4B,GAC5B,uBAAuB,CAAC;AAE5B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B;;;;OAIG;IACH,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAElC,OAAO,CAAC,KAAK,CAEN;IAEP,IAAI,IAAI,CAAC,IAAI,EAAE;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;KACpC,EAEA;IAED,IAAI,IAAI,IAAI;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;KACpC,CAOA;IAED,KAAK,EAAE,aAAa,CAAW;IAE/B;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAE5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;gBAExB,EACV,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,EAAE,EAClB,KAAK,EACL,MAAM,EACN,KAAK,EACL,GAAG,EACH,IAAI,EACJ,OAAO,EACP,WAAW,EACX,UAAU,GACX,EAAE,cAAc;CAwKlB"}

package/dist/errors/BeraError.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BeraError.unit.test.d.ts.map

package/dist/errors/BeraError.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeraError.unit.test.d.ts","sourceRoot":"","sources":["../../src/errors/BeraError.unit.test.ts"],"names":[],"mappings":""}

package/dist/errors/BeraMonitoring.d.ts

@@ -0,0 +1,46 @@
+import { type EmitterMixin } from "../utils/createEmitter";
+import type { BeraError } from "./BeraError";
+import type { SeverityLevel } from "./severity";
+/**
+ * Context passed alongside captured exceptions.
+ * Mirrors the subset of Sentry's CaptureContext that berajs actually uses.
+ */
+export interface CaptureContext {
+    level: SeverityLevel;
+    extra?: Record<string, unknown>;
+    tags?: Record<string, string | number | boolean | null | undefined>;
+    fingerprint?: string[];
+    data?: Record<string, unknown>;
+}
+export interface ErrorEvent {
+    exception: BeraError;
+    timestamp: number;
+}
+/**
+ * A generic error reporter for berajs.
+ *
+ * Instead of calling Sentry.captureException directly, berajs calls
+ * `BeraMonitoring.captureException()`. Consumer apps subscribe via `.on()` and
+ * forward events to their monitoring provider (Sentry, Datadog, etc.).
+ *
+ * @example
+ * ```ts
+ * // In berajs code:
+ * import { BeraMonitoring } from "./BeraMonitoring";
+ * BeraMonitoring.captureExceptionException(error);
+ *
+ * // In app instrumentation:
+ * import { BeraMonitoring } from "@berachain/berajs/errors";
+ * BeraMonitoring.on((event) => {
+ *   if (event.type === "exception") {
+ *     Sentry.captureException(event.exception);
+ *   }
+ * });
+ * ```
+ */
+export declare const BeraMonitoring: {
+    captureException: (exception: BeraError) => void;
+} & EmitterMixin<{
+    exception: (event: ErrorEvent) => void;
+}>;
+//# sourceMappingURL=BeraMonitoring.d.ts.map

package/dist/errors/BeraMonitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeraMonitoring.d.ts","sourceRoot":"","sources":["../../src/errors/BeraMonitoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACpE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,EAAE;IAC3B,gBAAgB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAClD,GAAG,YAAY,CAAC;IAAE,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CAAE,CAkB1D,CAAC"}

package/dist/errors/BeraTracing.d.ts

@@ -0,0 +1,58 @@
+import type { Unsubscribe } from "../utils/createEmitter";
+/**
+ * Span context passed to tracing handlers.
+ * Compatible with Sentry's StartSpanOptions (name, op, attributes).
+ */
+export type SpanContext = {
+    name: string;
+    op: string;
+    attributes: Record<string, string | number | boolean | undefined>;
+};
+/**
+ * A function that wraps a callback in a tracing span.
+ * Compatible with Sentry.startSpan's signature.
+ */
+type StartSpanFn = <T>(context: SpanContext, callback: () => Promise<T>) => Promise<T>;
+/**
+ * A generic span-tracing module for berajs.
+ *
+ * Instead of calling Sentry.startSpan directly, berajs calls
+ * `BeraTracing.startSpan()`. Consumer apps subscribe via `.on("span", handler)`
+ * and forward spans to their tracing provider (Sentry, Datadog, etc.).
+ *
+ * Multiple handlers are supported and chain in registration order:
+ * the first registered handler is the outermost wrapper.
+ *
+ * @example
+ * ```ts
+ * // In berajs code:
+ * import { BeraTracing } from "./BeraTracing";
+ * const result = await BeraTracing.startSpan(
+ *   { name: "GraphQL query", op: "graphql.query", attributes: {} },
+ *   () => executeQuery(),
+ * );
+ *
+ * // In app instrumentation:
+ * import { BeraTracing } from "@berachain/berajs/errors";
+ * BeraTracing.addSpanHandler(Sentry.startSpan);
+ * ```
+ */
+export declare const BeraTracing: {
+    /**
+     * Execute a callback, wrapping it in all registered span handlers.
+     *
+     * Handlers chain so each wraps the next. First registered = outermost wrapper.
+     * If no handlers are registered, the callback is executed directly.
+     */
+    startSpan<T>(context: SpanContext, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Register a span tracing handler.
+     *
+     * @param _event - Must be "span". Exists for API consistency with BeraMonitoring.
+     * @param handler - A StartSpanFn, e.g. Sentry.startSpan.
+     * @returns An unsubscribe function to remove the handler.
+     */
+    addSpanHandler(handler: StartSpanFn): Unsubscribe;
+};
+export {};
+//# sourceMappingURL=BeraTracing.d.ts.map

package/dist/errors/BeraTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeraTracing.d.ts","sourceRoot":"","sources":["../../src/errors/BeraTracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CACnE,CAAC;AAEF;;;GAGG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,EACnB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACvB,OAAO,CAAC,CAAC,CAAC,CAAC;AAIhB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,WAAW;IACtB;;;;;OAKG;cACO,CAAC,WAAW,WAAW,YAAY,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAU1E;;;;;;OAMG;4BACqB,WAAW,GAAG,WAAW;CAOlD,CAAC"}

package/dist/errors/BeraTracing.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BeraTracing.unit.test.d.ts.map

package/dist/errors/BeraTracing.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BeraTracing.unit.test.d.ts","sourceRoot":"","sources":["../../src/errors/BeraTracing.unit.test.ts"],"names":[],"mappings":""}

package/dist/errors/InvalidArgumentError.d.ts

@@ -0,0 +1,59 @@
+import { BeraError, type IBeraErrorArgs } from "./BeraError";
+export interface IInvalidArgumentErrorArgs extends IBeraErrorArgs {
+    /**
+     * The name of the argument that is invalid.
+     */
+    property: string;
+    /**
+     * The value of the argument that is invalid.
+     */
+    value: unknown;
+    /**
+     * The expected type of the value as a string, eg. string, number, boolean, etc.
+     */
+    expected: string;
+}
+/**
+ * Error thrown when argument validation fails. (e.g. an argument is missing or invalid)
+ *
+ * Default level is "warning".
+ *
+ * @example ```ts
+ * if (!publicClient) {
+ *  throw new InvalidArgumentError({
+ *    property: "publicClient",
+ *    value: publicClient,
+ *    expected: "PublicClient",
+ *  });
+ * }
+ * if (!address || !isAddress(address)) {
+ *  throw new InvalidArgumentError({
+ *    property: "address",
+ *    value: address,
+ *    expected: "Address",
+ *  });
+ * }
+ * ```
+ *
+ */
+export declare class InvalidArgumentError extends BeraError {
+    /**
+     * The name of the argument that is invalid.
+     */
+    property: string;
+    /**
+     * The value of the argument that is invalid.
+     */
+    value: unknown;
+    /**
+     * The expected value of the argument.
+     */
+    expected: string;
+    constructor(args: IInvalidArgumentErrorArgs);
+    get isMissing(): boolean;
+    /**
+     * Whether the argument is defined but invalid.
+     */
+    get isInvalid(): boolean;
+}
+//# sourceMappingURL=InvalidArgumentError.d.ts.map

package/dist/errors/InvalidArgumentError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidArgumentError.d.ts","sourceRoot":"","sources":["../../src/errors/InvalidArgumentError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,yBAA0B,SAAQ,cAAc;IAC/D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;gBAEL,IAAI,EAAE,yBAAyB;IAc3C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/errors/NotFoundError.d.ts

@@ -0,0 +1,25 @@
+import { BeraError, type IBeraErrorArgs } from "./BeraError";
+export interface INotFoundErrorArgs extends IBeraErrorArgs {
+    resource: string;
+    id: string;
+    chainId: number;
+}
+/**
+ * Error thrown when a resource is not found.
+ */
+export declare class NotFoundError extends BeraError {
+    /**
+     * The name of the resource that was not found.
+     *
+     * @example "Reward vault"
+     */
+    resource: string;
+    /**
+     * The id of the resource that was not found.
+     *
+     * @example "0x1234567890123456789012345678901234567890"
+     */
+    id: string;
+    constructor(args: INotFoundErrorArgs);
+}
+//# sourceMappingURL=NotFoundError.d.ts.map

package/dist/errors/NotFoundError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundError.d.ts","sourceRoot":"","sources":["../../src/errors/NotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;gBAEC,IAAI,EAAE,kBAAkB;CAQrC"}

package/dist/errors/RequestError.d.ts

@@ -0,0 +1,56 @@
+import type { ErrorLike } from "@apollo/client";
+import { BeraError, type IBeraErrorArgs } from "./BeraError";
+/**
+ * This is an error class that should be used to handle errors from fetch requests.
+ */
+export declare class RequestError extends BeraError {
+    /**
+     * The error response from the request.
+     */
+    response: Response | ErrorLike | undefined;
+    static isCorsError(error: Error): boolean;
+    /**
+     * The endpoint that was requested.
+     */
+    endpoint: {
+        name?: string;
+        url: string;
+        type?: "rest" | "graphql" | "rpc";
+    };
+    /**
+     * A list of domains that should have their query params removed.
+     */
+    private queryRichfulDomains;
+    statusCode: number | undefined;
+    payload?: object;
+    static readonly REASON_MAP: {
+        readonly 429: "RATE_LIMITED_429";
+        readonly NETWORK_ERROR: "NETWORK_ERROR";
+        readonly CORS_ERROR: "CORS";
+        readonly NO_SWAP_PATHS: "NO_SWAP_PATHS";
+    };
+    constructor(args: IBeraErrorArgs & {
+        response: Response | ErrorLike | undefined;
+        /**
+         * The payload sent to the request.
+         */
+        payload?: object;
+        endpoint: string | URL | {
+            name?: string;
+            url: string | URL;
+            type: "rest" | "graphql" | "rpc";
+        };
+        statusCode?: number;
+    });
+    setEndpoint(endpoint: string | URL | {
+        name?: string;
+        url: string | URL;
+        type?: "rest" | "graphql" | "rpc";
+    }): {
+        name?: string;
+        url: string;
+        type?: "rest" | "graphql" | "rpc";
+    };
+    private tryMatchNetworkError;
+}
+//# sourceMappingURL=RequestError.d.ts.map

package/dist/errors/RequestError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestError.d.ts","sourceRoot":"","sources":["../../src/errors/RequestError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAE3C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK;IAG/B;;OAEG;IACH,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;KACnC,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAYzB;IAEF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,QAAQ,CAAC,UAAU;;;;;MAOf;gBAGT,IAAI,EAAE,cAAc,GAAG;QACrB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;QAC3C;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EACJ,MAAM,GACN,GAAG,GACH;YACE,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;YAClB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;SAClC,CAAC;QACN,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IA8EH,WAAW,CACT,QAAQ,EACJ,MAAM,GACN,GAAG,GACH;QACE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;KACnC;eAzIE,MAAM;aACR,MAAM;eACJ,MAAM,GAAG,SAAS,GAAG,KAAK;;IA8KnC,OAAO,CAAC,oBAAoB;CAkE7B"}

package/dist/errors/RequestError.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RequestError.unit.test.d.ts.map

package/dist/errors/RequestError.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestError.unit.test.d.ts","sourceRoot":"","sources":["../../src/errors/RequestError.unit.test.ts"],"names":[],"mappings":""}

package/dist/errors/TransactionFailedError.d.ts

@@ -0,0 +1,49 @@
+import type { Hex } from "@berachain-foundation/berancer-sdk";
+import type { Address, TransactionReceipt } from "viem";
+import { BeraError, type IBeraErrorArgs } from "./BeraError";
+/**
+ * This error is generally thrown by beraWriteContract when a transaction or simulation fails.
+ */
+export declare class TransactionFailedError extends BeraError {
+    /**
+     * The hash of the transaction that failed.
+     *
+     * Null if the error is due to a simulation failure.
+     */
+    txHash: string | null;
+    /**
+     * The receipt of the transaction that failed.
+     *
+     * Null if the error is due to a simulation failure.
+     */
+    receipt: TransactionReceipt | null;
+    /**
+     * The address of the contract that was called.
+     */
+    to: Address | undefined;
+    /**
+     * The data of the transaction that failed.
+     */
+    callData: Hex | undefined;
+    /**
+     * The block number of the transaction that failed.
+     */
+    blockNumber: bigint | null;
+    /**
+     * The input of the transaction that failed.
+     */
+    input: object;
+    /**
+     * The function name of the transaction that failed.
+     */
+    functionName: string | undefined;
+    constructor(args: IBeraErrorArgs & {
+        txHash?: string;
+        receipt?: TransactionReceipt;
+        to?: Address;
+        blockNumber?: bigint;
+        functionName?: string;
+        input: object;
+    });
+}
+//# sourceMappingURL=TransactionFailedError.d.ts.map

package/dist/errors/TransactionFailedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionFailedError.d.ts","sourceRoot":"","sources":["../../src/errors/TransactionFailedError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACnD;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;OAIG;IACH,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,EAAE,EAAE,OAAO,GAAG,SAAS,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,GAAG,GAAG,SAAS,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;gBAG/B,IAAI,EAAE,cAAc,GAAG;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,kBAAkB,CAAC;QAC7B,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf;CAoCJ"}

package/dist/errors/assert.d.ts

@@ -0,0 +1,82 @@
+import type { GetPublicClientReturnType } from "@wagmi/core";
+import { type Address, type PublicClient } from "viem";
+/**
+ * Asserts that a value is defined.
+ * @throws An InvalidArgumentError if the value is undefined or null.
+ */
+export declare function assertDefined<T>(
+/**
+ * The value to assert.
+ */
+value: T, 
+/**
+ * The property name.
+ */
+property: string): asserts value is NonNullable<T>;
+/**
+ * Asserts that a value is a PublicClient.
+ * @throws An InvalidArgumentError if the value is undefined or not a PublicClient.
+ */
+export declare function assertPublicClient(
+/**
+ * The value to assert.
+ */
+value: // it's important to have both types here because it helps with typescript build performance
+PublicClient | GetPublicClientReturnType | undefined, 
+/**
+ * The property name.
+ */
+property?: string): asserts value is PublicClient;
+/**
+ * Asserts that a value is an address (20 bytes).
+ * @throws An InvalidArgumentError if the value is undefined, null, not a string, or not an address.
+ */
+export declare function assertAddress(
+/**
+ * The value to assert.
+ */
+value: string | undefined | null, 
+/**
+ * The property name.
+ */
+property: string): asserts value is Address;
+/**
+ * Asserts that a value is positive (> 0).
+ * @throws An InvalidArgumentError if the value is not positive.
+ */
+export declare function assertPositive(
+/**
+ * The value to assert.
+ */
+value: string | bigint | number, 
+/**
+ * The property name.
+ */
+property: string): void;
+/**
+ * Asserts that a value is an integer.
+ * @throws An InvalidArgumentError if the value is not an integer.
+ */
+export declare function assertInteger(
+/**
+ * The value to assert.
+ */
+value: number, 
+/**
+ * The property name.
+ */
+property: string): void;
+/**
+ * Asserts that a value is a number greater than 0.
+ * @throws An InvalidArgumentError if the value is undefined, null, not a string or number, or not a number greater than 0.
+ */
+export declare function assertAmount(
+/**
+ * The value to assert.
+ */
+value: unknown, 
+/**
+ * The property name.
+ */
+property: string): asserts value is string | number;
+//# sourceMappingURL=assert.d.ts.map

package/dist/errors/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/errors/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,KAAK,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAwDlE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC;AAC7B;;GAEG;AACH,KAAK,EAAE,CAAC;AACR;;GAEG;AACH,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAMjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB;AAChC;;GAEG;AACH,KAAK,EACL,AADO,4FAA4F;AACnG,YAAY,GAAG,yBAAyB,GAAG,SAAS;AACpD;;GAEG;AACH,QAAQ,GAAE,MAAuB,GAChC,OAAO,CAAC,KAAK,IAAI,YAAY,CAG/B;AAED;;;GAGG;AACH,wBAAgB,aAAa;AAC3B;;GAEG;AACH,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;AAChC;;GAEG;AACH,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,OAAO,CAS1B;AAED;;;GAGG;AACH,wBAAgB,cAAc;AAC5B;;GAEG;AACH,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;AAC/B;;GAEG;AACH,QAAQ,EAAE,MAAM,GACf,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,aAAa;AAC3B;;GAEG;AACH,KAAK,EAAE,MAAM;AACb;;GAEG;AACH,QAAQ,EAAE,MAAM,GACf,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,YAAY;AAC1B;;GAEG;AACH,KAAK,EAAE,OAAO;AACd;;GAEG;AACH,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,MAAM,CAWlC"}

package/dist/errors/assert.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assert.unit.test.d.ts.map