@0xsequence/wallet-primitives 0.0.0-20250520201059

package/dist/permission.d.ts

@@ -0,0 +1,73 @@
+import { Address, Bytes } from 'ox';
+export declare enum ParameterOperation {
+    EQUAL = 0,
+    NOT_EQUAL = 1,
+    GREATER_THAN_OR_EQUAL = 2,
+    LESS_THAN_OR_EQUAL = 3
+}
+export type ParameterRule = {
+    cumulative: boolean;
+    operation: ParameterOperation;
+    value: Bytes.Bytes;
+    offset: bigint;
+    mask: Bytes.Bytes;
+};
+export type Permission = {
+    target: Address.Address;
+    rules: ParameterRule[];
+};
+export type SessionPermissions = {
+    signer: Address.Address;
+    valueLimit: bigint;
+    deadline: bigint;
+    permissions: [Permission, ...Permission[]];
+};
+export declare const MAX_PERMISSIONS_COUNT: number;
+export declare const MAX_RULES_COUNT: number;
+export declare function encodeSessionPermissions(sessionPermissions: SessionPermissions): Bytes.Bytes;
+export declare function encodePermission(permission: Permission): Bytes.Bytes;
+export declare function decodeSessionPermissions(bytes: Bytes.Bytes): SessionPermissions;
+export declare const permissionStructAbi: {
+    readonly internalType: "struct Permission";
+    readonly name: "permission";
+    readonly type: "tuple";
+    readonly components: readonly [{
+        readonly internalType: "address";
+        readonly name: "target";
+        readonly type: "address";
+    }, {
+        readonly internalType: "struct ParameterRule[]";
+        readonly name: "rules";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly internalType: "bool";
+            readonly name: "cumulative";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "enum ParameterOperation";
+            readonly name: "operation";
+            readonly type: "uint8";
+        }, {
+            readonly internalType: "bytes32";
+            readonly name: "value";
+            readonly type: "bytes32";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "offset";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "bytes32";
+            readonly name: "mask";
+            readonly type: "bytes32";
+        }];
+    }];
+};
+export declare function abiEncodePermission(permission: Permission): string;
+export declare function sessionPermissionsToJson(sessionPermissions: SessionPermissions): string;
+export declare function encodeSessionPermissionsForJson(sessionPermissions: SessionPermissions): any;
+export declare function permissionToJson(permission: Permission): string;
+export declare function parameterRuleToJson(rule: ParameterRule): string;
+export declare function sessionPermissionsFromJson(json: string): SessionPermissions;
+export declare function sessionPermissionsFromParsed(parsed: any): SessionPermissions;
+export declare function permissionFromJson(json: string): Permission;
+//# sourceMappingURL=permission.d.ts.map

package/dist/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAA;AAElD,oBAAY,kBAAkB;IAC5B,KAAK,IAAI;IACT,SAAS,IAAI;IACb,qBAAqB,IAAI;IACzB,kBAAkB,IAAI;CACvB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,CAAC,KAAK,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAA;IACvB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,CAAC,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC,CAAA;CAC3C,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAa,CAAA;AAC/C,eAAO,MAAM,eAAe,QAAa,CAAA;AAIzC,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,KAAK,CAAC,KAAK,CAc5F;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,KAAK,CAWpE;AAiBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,kBAAkB,CAsB/E;AAwCD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBtB,CAAA;AAEV,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAgBlE;AAID,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,MAAM,CAEvF;AAED,wBAAgB,+BAA+B,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,GAAG,CAO3F;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D;AASD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE/D;AAYD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,GAAG,GAAG,kBAAkB,CAO5E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE3D"}

package/dist/permission.js

@@ -0,0 +1,188 @@
+import { AbiParameters, Address, Bytes } from 'ox';
+export var ParameterOperation;
+(function (ParameterOperation) {
+    ParameterOperation[ParameterOperation["EQUAL"] = 0] = "EQUAL";
+    ParameterOperation[ParameterOperation["NOT_EQUAL"] = 1] = "NOT_EQUAL";
+    ParameterOperation[ParameterOperation["GREATER_THAN_OR_EQUAL"] = 2] = "GREATER_THAN_OR_EQUAL";
+    ParameterOperation[ParameterOperation["LESS_THAN_OR_EQUAL"] = 3] = "LESS_THAN_OR_EQUAL";
+})(ParameterOperation || (ParameterOperation = {}));
+export const MAX_PERMISSIONS_COUNT = 2 ** 7 - 1;
+export const MAX_RULES_COUNT = 2 ** 8 - 1;
+// Encoding
+export function encodeSessionPermissions(sessionPermissions) {
+    if (sessionPermissions.permissions.length > MAX_PERMISSIONS_COUNT) {
+        throw new Error('Too many permissions');
+    }
+    const encodedPermissions = sessionPermissions.permissions.map(encodePermission);
+    return Bytes.concat(Bytes.padLeft(Bytes.fromHex(sessionPermissions.signer), 20), Bytes.padLeft(Bytes.fromNumber(sessionPermissions.valueLimit), 32), Bytes.padLeft(Bytes.fromNumber(sessionPermissions.deadline), 32), Bytes.fromNumber(sessionPermissions.permissions.length, { size: 1 }), Bytes.concat(...encodedPermissions));
+}
+export function encodePermission(permission) {
+    if (permission.rules.length > MAX_RULES_COUNT) {
+        throw new Error('Too many rules');
+    }
+    const encodedRules = permission.rules.map(encodeParameterRule);
+    return Bytes.concat(Bytes.padLeft(Bytes.fromHex(permission.target), 20), Bytes.fromNumber(permission.rules.length, { size: 1 }), Bytes.concat(...encodedRules));
+}
+function encodeParameterRule(rule) {
+    // Combine operation and cumulative flag into a single byte
+    // 0x[operationx3][cumulative]
+    const operationCumulative = (Number(rule.operation) << 1) | (rule.cumulative ? 1 : 0);
+    return Bytes.concat(Bytes.fromNumber(operationCumulative), Bytes.padLeft(rule.value, 32), Bytes.padLeft(Bytes.fromNumber(rule.offset), 32), Bytes.padLeft(rule.mask, 32));
+}
+// Decoding
+export function decodeSessionPermissions(bytes) {
+    const signer = Bytes.toHex(bytes.slice(0, 20));
+    const valueLimit = Bytes.toBigInt(bytes.slice(20, 52));
+    const deadline = Bytes.toBigInt(bytes.slice(52, 84));
+    const permissionsLength = Number(bytes[84]);
+    const permissions = [];
+    let pointer = 85;
+    for (let i = 0; i < permissionsLength; i++) {
+        // Pass the remaining bytes instead of a fixed slice length
+        const { permission, consumed } = decodePermission(bytes.slice(pointer));
+        permissions.push(permission);
+        pointer += consumed;
+    }
+    if (permissions.length === 0) {
+        throw new Error('No permissions');
+    }
+    return {
+        signer,
+        valueLimit,
+        deadline,
+        permissions: permissions,
+    };
+}
+// Returns the permission and the number of bytes consumed in the permission block
+function decodePermission(bytes) {
+    const target = Bytes.toHex(bytes.slice(0, 20));
+    const rulesLength = Number(bytes[20]);
+    const rules = [];
+    let pointer = 21;
+    for (let i = 0; i < rulesLength; i++) {
+        const ruleBytes = bytes.slice(pointer, pointer + 97);
+        rules.push(decodeParameterRule(ruleBytes));
+        pointer += 97;
+    }
+    return {
+        permission: {
+            target,
+            rules,
+        },
+        consumed: pointer,
+    };
+}
+function decodeParameterRule(bytes) {
+    const operationCumulative = Number(bytes[0]);
+    const cumulative = (operationCumulative & 1) === 1;
+    const operation = operationCumulative >> 1;
+    const value = bytes.slice(1, 33);
+    const offset = Bytes.toBigInt(bytes.slice(33, 65));
+    const mask = bytes.slice(65, 97);
+    return {
+        cumulative,
+        operation,
+        value,
+        offset,
+        mask,
+    };
+}
+// ABI encode
+export const permissionStructAbi = {
+    internalType: 'struct Permission',
+    name: 'permission',
+    type: 'tuple',
+    components: [
+        { internalType: 'address', name: 'target', type: 'address' },
+        {
+            internalType: 'struct ParameterRule[]',
+            name: 'rules',
+            type: 'tuple[]',
+            components: [
+                { internalType: 'bool', name: 'cumulative', type: 'bool' },
+                {
+                    internalType: 'enum ParameterOperation',
+                    name: 'operation',
+                    type: 'uint8',
+                },
+                { internalType: 'bytes32', name: 'value', type: 'bytes32' },
+                { internalType: 'uint256', name: 'offset', type: 'uint256' },
+                { internalType: 'bytes32', name: 'mask', type: 'bytes32' },
+            ],
+        },
+    ],
+};
+export function abiEncodePermission(permission) {
+    return AbiParameters.encode([permissionStructAbi], [
+        {
+            target: permission.target,
+            rules: permission.rules.map((rule) => ({
+                cumulative: rule.cumulative,
+                operation: rule.operation,
+                value: Bytes.toHex(rule.value),
+                offset: rule.offset,
+                mask: Bytes.toHex(rule.mask),
+            })),
+        },
+    ]);
+}
+// JSON
+export function sessionPermissionsToJson(sessionPermissions) {
+    return JSON.stringify(encodeSessionPermissionsForJson(sessionPermissions));
+}
+export function encodeSessionPermissionsForJson(sessionPermissions) {
+    return {
+        signer: sessionPermissions.signer.toString(),
+        valueLimit: sessionPermissions.valueLimit.toString(),
+        deadline: sessionPermissions.deadline.toString(),
+        permissions: sessionPermissions.permissions.map(encodePermissionForJson),
+    };
+}
+export function permissionToJson(permission) {
+    return JSON.stringify(encodePermissionForJson(permission));
+}
+function encodePermissionForJson(permission) {
+    return {
+        target: permission.target.toString(),
+        rules: permission.rules.map(encodeParameterRuleForJson),
+    };
+}
+export function parameterRuleToJson(rule) {
+    return JSON.stringify(encodeParameterRuleForJson(rule));
+}
+function encodeParameterRuleForJson(rule) {
+    return {
+        cumulative: rule.cumulative,
+        operation: rule.operation,
+        value: Bytes.toHex(rule.value),
+        offset: rule.offset.toString(),
+        mask: Bytes.toHex(rule.mask),
+    };
+}
+export function sessionPermissionsFromJson(json) {
+    return sessionPermissionsFromParsed(JSON.parse(json));
+}
+export function sessionPermissionsFromParsed(parsed) {
+    return {
+        signer: Address.from(parsed.signer),
+        valueLimit: BigInt(parsed.valueLimit),
+        deadline: BigInt(parsed.deadline),
+        permissions: parsed.permissions.map(permissionFromParsed),
+    };
+}
+export function permissionFromJson(json) {
+    return permissionFromParsed(JSON.parse(json));
+}
+function permissionFromParsed(parsed) {
+    return {
+        target: Address.from(parsed.target),
+        rules: parsed.rules.map((decoded) => ({
+            cumulative: decoded.cumulative,
+            operation: decoded.operation,
+            value: Bytes.fromHex(decoded.value),
+            offset: BigInt(decoded.offset),
+            mask: Bytes.fromHex(decoded.mask),
+        })),
+    };
+}
+//# sourceMappingURL=permission.js.map

package/dist/permission.js.map

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

package/dist/session-config.d.ts

@@ -0,0 +1,113 @@
+import { Address, Bytes, Hex } from 'ox';
+import * as GenericTree from './generic-tree.js';
+import { SessionPermissions } from './permission.js';
+export declare const SESSIONS_FLAG_PERMISSIONS = 0;
+export declare const SESSIONS_FLAG_NODE = 1;
+export declare const SESSIONS_FLAG_BRANCH = 2;
+export declare const SESSIONS_FLAG_BLACKLIST = 3;
+export declare const SESSIONS_FLAG_IDENTITY_SIGNER = 4;
+export type ImplicitBlacklistLeaf = {
+    type: 'implicit-blacklist';
+    blacklist: Address.Address[];
+};
+export type IdentitySignerLeaf = {
+    type: 'identity-signer';
+    identitySigner: Address.Address;
+};
+export type SessionPermissionsLeaf = SessionPermissions & {
+    type: 'session-permissions';
+};
+export type SessionNode = Hex.Hex;
+export type SessionLeaf = SessionPermissionsLeaf | ImplicitBlacklistLeaf | IdentitySignerLeaf;
+export type SessionBranch = [SessionsTopology, SessionsTopology, ...SessionsTopology[]];
+export type SessionsTopology = SessionBranch | SessionLeaf | SessionNode;
+export declare function isSessionsTopology(topology: any): topology is SessionsTopology;
+/**
+ * Checks if the topology is complete.
+ * A complete topology has exactly one identity signer and one blacklist.
+ * @param topology The topology to check
+ * @returns True if the topology is complete
+ */
+export declare function isCompleteSessionsTopology(topology: any): topology is SessionsTopology;
+/**
+ * Gets the identity signer from the topology.
+ * @param topology The topology to get the identity signer from
+ * @returns The identity signer or null if it's not present
+ */
+export declare function getIdentitySigner(topology: SessionsTopology): Address.Address | null;
+/**
+ * Gets the implicit blacklist from the topology.
+ * @param topology The topology to get the implicit blacklist from
+ * @returns The implicit blacklist or null if it's not present
+ */
+export declare function getImplicitBlacklist(topology: SessionsTopology): Address.Address[] | null;
+/**
+ * Gets the implicit blacklist leaf from the topology.
+ * @param topology The topology to get the implicit blacklist leaf from
+ * @returns The implicit blacklist leaf or null if it's not present
+ */
+export declare function getImplicitBlacklistLeaf(topology: SessionsTopology): ImplicitBlacklistLeaf | null;
+export declare function getSessionPermissions(topology: SessionsTopology, address: Address.Address): SessionPermissions | null;
+export declare function getExplicitSigners(topology: SessionsTopology): Address.Address[];
+/**
+ * Encodes a leaf to bytes.
+ * This can be Hash.keccak256'd to convert to a node..
+ * @param leaf The leaf to encode
+ * @returns The encoded leaf
+ */
+export declare function encodeLeafToGeneric(leaf: SessionLeaf): GenericTree.Leaf;
+export declare function decodeLeafFromBytes(bytes: Bytes.Bytes): SessionLeaf;
+export declare function sessionsTopologyToConfigurationTree(topology: SessionsTopology): GenericTree.Tree;
+export declare function configurationTreeToSessionsTopology(tree: GenericTree.Tree): SessionsTopology;
+/**
+ * Encodes a topology into bytes for contract validation.
+ * @param topology The topology to encode
+ * @returns The encoded topology
+ */
+export declare function encodeSessionsTopology(topology: SessionsTopology): Bytes.Bytes;
+export declare function sessionsTopologyToJson(topology: SessionsTopology): string;
+export declare function sessionsTopologyFromJson(json: string): SessionsTopology;
+/**
+ * Removes all explicit sessions (permissions leaf nodes) that match the given signer from the topology.
+ * Returns the updated topology or null if it becomes empty (for nesting).
+ * If the signer is not found, the topology is returned unchanged.
+ */
+export declare function removeExplicitSession(topology: SessionsTopology, signerAddress: `0x${string}`): SessionsTopology | null;
+export declare function addExplicitSession(topology: SessionsTopology, sessionPermissions: SessionPermissions): SessionsTopology;
+/**
+ * Merges two topologies into a new branch of [a, b].
+ */
+export declare function mergeSessionsTopologies(a: SessionsTopology, b: SessionsTopology): SessionsTopology;
+/**
+ * Balances the topology by flattening and rebuilding as a balanced binary tree.
+ * This does not make a binary tree as the blacklist and identity signer are included at the top level.
+ */
+export declare function balanceSessionsTopology(topology: SessionsTopology): SessionsTopology;
+/**
+ * Cleans a topology by removing leaves (SessionPermissions) whose deadline has expired.
+ *    - currentTime is compared against `session.deadline`.
+ *    - If a branch ends up with zero valid leaves, return `null`.
+ *    - If it has one child, collapse that child upward.
+ */
+export declare function cleanSessionsTopology(topology: SessionsTopology, currentTime?: bigint): SessionsTopology | null;
+/**
+ * Minimise the topology by rolling unused signers into nodes.
+ * @param topology The topology to minimise
+ * @param signers The list of signers to consider
+ * @returns The minimised topology
+ */
+export declare function minimiseSessionsTopology(topology: SessionsTopology, explicitSigners?: Address.Address[], implicitSigners?: Address.Address[]): SessionsTopology;
+/**
+ * Adds an address to the implicit session's blacklist.
+ * If the address is not already in the blacklist, it is added and the list is sorted.
+ */
+export declare function addToImplicitBlacklist(topology: SessionsTopology, address: Address.Address): SessionsTopology;
+/**
+ * Removes an address from the implicit session's blacklist.
+ */
+export declare function removeFromImplicitBlacklist(topology: SessionsTopology, address: Address.Address): SessionsTopology;
+/**
+ *  Generate an empty sessions topology with the given identity signer. No session permission and an empty blacklist
+ */
+export declare function emptySessionsTopology(identitySigner: Address.Address): SessionsTopology;
+//# sourceMappingURL=session-config.d.ts.map

package/dist/session-config.d.ts.map

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