@berachain/berajs 0.2.12 → 0.3.0

package/dist/enum/governance.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Maps the proposal state from the governor contract to a more human-readable format.
+ * Don't edit this enum manually, it's synced with the governor contract.
+ *
+ * @see https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/governance/IGovernor.sol
+ */
+export declare enum ProposalState {
+    Pending = 0,
+    Active = 1,
+    Canceled = 2,
+    Defeated = 3,
+    Succeeded = 4,
+    Queued = 5,
+    Expired = 6,
+    Executed = 7
+}
+export declare enum VoteEnum {
+    AGAINST = "no",
+    FOR = "yes",
+    ABSTAIN = "abstain"
+}
+export declare enum ProposalErrorCodes {
+    REQUIRED = "Required",
+    INVALID_AMOUNT = "Invalid amount",
+    NEGATIVE_AMOUNT = "Negative amount",
+    INVALID_ADDRESS = "Invalid address",
+    INVALID_ACTION = "Invalid action",
+    INVALID_ABI = "Invalid ABI",
+    MUST_BE_HTTPS = "Must be HTTPS",
+    MUST_BE_HTTPS_OR_IPFS = "Must be HTTPS or IPFS",
+    INVALID_BASEPATH = "Must be a berachain forum link",
+    /**
+     * Mainly used when it's not a reward vault
+     */
+    INVALID_CONTRACT = "This is not a valid contract"
+}
+export declare enum ProposalTypeEnum {
+    CUSTOM_PROPOSAL = "custom-action",
+    WHITELIST_REWARD_VAULT = "whitelist-reward-vault",
+    BLACKLIST_REWARD_VAULT = "blacklist-reward-vault",
+    ERC20_TRANSFER = "erc20-transfer",
+    WHITELIST_REWARD_VAULT_INCENTIVE = "whitelist-reward-vault-incentive"
+}
+export declare const VoteColorMap: {
+    readonly yes: "#059669";
+    readonly 1: "#059669";
+    readonly no: "#DC2629";
+    readonly 2: "#DC2629";
+    readonly veto: "#0284C7";
+    readonly 4: "#0284C7";
+    readonly abstain: "#78716c";
+    readonly 3: "#78716c";
+    readonly yes_secondary: "#ECFDF5";
+    readonly no_secondary: "#FEF2F2";
+    readonly veto_secondary: "#F0F9FF";
+    readonly abstain_secondary: "#E7E5E4";
+    readonly default: "#57534e";
+};
+//# sourceMappingURL=governance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/enum/governance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,MAAM,IAAI;IACV,OAAO,IAAI;IACX,QAAQ,IAAI;CACb;AACD,oBAAY,QAAQ;IAClB,OAAO,OAAO;IACd,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,qBAAqB,0BAA0B;IAC/C,gBAAgB,mCAAmC;IACnD;;OAEG;IACH,gBAAgB,iCAAiC;CAClD;AAED,oBAAY,gBAAgB;IAC1B,eAAe,kBAAkB;IACjC,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,cAAc,mBAAmB;IACjC,gCAAgC,qCAAqC;CACtE;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAcf,CAAC"}

package/dist/{honey-CYm0RWf4.d.ts → enum/honey.d.ts}

@@ -1,4 +1,4 @@
-declare enum HoneySwapAction {
+export declare enum HoneySwapAction {
     RESET_AMOUNTS = "RESET_AMOUNTS",
     ACTION_TYPE_CHANGE = "ACTION_TYPE_CHANGE",
     COLLATERALS_CHANGE = "COLLATERALS_CHANGE",
@@ -10,5 +10,4 @@ declare enum HoneySwapAction {
     IS_SUBMITTING_CHANGE = "IS_SUBMITTING_CHANGE",
     IS_LOADING_CHANGE = "IS_LOADING_CHANGE"
 }
-
-export { HoneySwapAction as H };
+//# sourceMappingURL=honey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"honey.d.ts","sourceRoot":"","sources":["../../src/enum/honey.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,6BAA6B,kCAAkC;IAC/D,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;CACxC"}

package/dist/enum/polling.d.ts

@@ -0,0 +1,8 @@
+declare enum POLLING {
+    FAST = 10000,// 10 sec
+    NORMAL = 100000,// 100 sec
+    SLOW = 180000,// 3 min
+    REFRESH_BLOCK_INTERVAL = 10000
+}
+export { POLLING };
+//# sourceMappingURL=polling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/enum/polling.ts"],"names":[],"mappings":"AAAA,aAAK,OAAO;IACV,IAAI,QAAQ,CAAE,SAAS;IACvB,MAAM,SAAS,CAAE,UAAU;IAC3B,IAAI,SAAS,CAAE,QAAQ;IACvB,sBAAsB,QAAQ;CAC/B;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

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/{txnEnum-ByI5dtDi.d.ts → enum/txnEnum.d.ts}

@@ -1,19 +1,4 @@
-/**
- * A list of contract names that are not mapped in the devrel's contract mapping or that are generated by factories (e.g. RewardVault).
- */
-declare enum ContractName {
-    ENSO_ROUTER = "enso.router",
-    POL_REWARD_VAULT = "pol.rewardVault",
-    POL_REWARD_VAULT_HELPER = "pol.rewardVaultHelper",
-    BEX_POOL = "bex.pool",
-    ERC20 = "others.erc20",
-    ERC4626 = "others.erc4626",
-    POL_STAKE_VAULT = "pol.stakeVault",
-    BEX_EXPLOITED_FUND_DISTRIBUTOR = "bex.exploitedFundDistributor",
-    TW_MINIMAL_ACCOUNT = "thirdweb.minimalAccount"
-}
-
-declare enum TransactionActionType {
+export declare enum TransactionActionType {
     /**
      * Used for testing purposes.
      */
@@ -102,5 +87,4 @@ declare enum TransactionActionType {
     BEND_CURATOR_SET_CURATOR = "Bend Curator Set Curator",
     BEND_CURATOR_SET_ALLOCATOR = "Bend Curator Set Allocator"
 }
-
-export { ContractName as C, TransactionActionType as T };
+//# 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/{BeraError-7-A5JYy_.d.ts → errors/BeraError.d.ts}

@@ -1,31 +1,7 @@
-import { Abi } from 'viem';
-
-/**
- * Severity levels for error reporting.
- * Mirrors Sentry's SeverityLevel for compatibility, but owned by berajs
- * so we don't depend on @sentry/nextjs.
- */
-type SeverityLevel = "fatal" | "error" | "warning" | "log" | "info" | "debug";
-
-/**
- * Span status codes for tracing.
- * Mirrors Sentry's SpanStatusType for compatibility, but owned by berajs
- * so we don't depend on @sentry/nextjs.
- *
- * @see https://develop.sentry.dev/sdk/foundations/transport/event-payloads/span/
- */
-type SpanStatusType = "ok" | "cancelled" | "unknown_error" | "invalid_argument" | "deadline_exceeded" | "not_found" | "already_exists" | "permission_denied" | "resource_exhausted" | "failed_precondition" | "aborted" | "out_of_range" | "unimplemented" | "internal_error" | "unavailable" | "data_loss" | "unauthenticated";
-/**
- * Maps an HTTP status code to a span status.
- */
-declare function httpStatusToSpanStatus(code: number): SpanStatusType;
-/**
- * Maps a BeraError reason code to a span status.
- * Returns undefined if no mapping exists (caller keeps existing spanStatus).
- */
-declare function reasonToSpanStatus(reason: string | null): SpanStatusType | undefined;
-
-interface IBeraErrorArgs {
+import { type Abi } from "viem";
+import type { SeverityLevel } from "./severity";
+import { type SpanStatusType } from "./spanStatus";
+export interface IBeraErrorArgs {
     message?: string;
     displayMessage?: string;
     cause?: unknown;
@@ -74,7 +50,7 @@ type TagsKey = "wallet.chain" | "wallet.connector" | "wallet.address" | "error.r
  * @see errorMap.ts — reason → displayMessage mapping
  * @see initBeraError — normalizes any error into a BeraError (preferred entry point)
  */
-declare class BeraError extends Error {
+export declare class BeraError extends Error {
     /**
      * A human-readable message that can be displayed to end user.
      *
@@ -119,5 +95,5 @@ declare class BeraError extends Error {
     extra: Record<string, unknown>;
     constructor({ message: m, displayMessage: dm, cause, reason, level, abi, tags, chainId, fingerprint, spanStatus, }: IBeraErrorArgs);
 }
-
-export { BeraError as B, type IBeraErrorArgs as I, type SeverityLevel as S, type SpanStatusType as a, httpStatusToSpanStatus as h, reasonToSpanStatus as r };
+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/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/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,75 @@
+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;
+    /**
+     * Matches the standard error messages browsers produce when fetch fails due
+     * to a network or CORS error, as empirically collected from Sentry. The
+     * trailing "(host)" suffix is our own annotation and optional: bare fetch
+     * TypeErrors are just "Failed to fetch" / "Load failed".
+     */
+    private static readonly NETWORK_ERROR_MESSAGE_REGEX;
+    /**
+     * Whether a message is a browser fetch network-failure message. Used to tell
+     * genuine network TypeErrors apart from ordinary TypeErrors (which must NOT
+     * be grouped as network errors — see sentryBeforeSend).
+     */
+    static isNetworkErrorMessage(message: string): 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;
+    });
+    /**
+     * The hostname of the requested endpoint (e.g. "beep.berachain.com"), used to
+     * group network errors by domain in Sentry. Falls back to the full url for
+     * relative/malformed urls that have no parseable host.
+     */
+    get host(): string;
+    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;IAI/B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAC2D;IAE9G;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMtD;;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;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAMjB;IAED,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;eAtJE,MAAM;aACR,MAAM;eACJ,MAAM,GAAG,SAAS,GAAG,KAAK;;IAmMnC,OAAO,CAAC,oBAAoB;CA6D7B"}

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"}