@aboutcircles/sdk-utils 0.1.4 → 0.1.6

package/dist/abi.d.ts

@@ -28,4 +28,28 @@ export declare function decodeErrorResult(config: {
     errorName: string;
     args?: any[];
 } | null;
+/**
+ * IMPORTANT: This is a lightweight encoding utility for SIMPLE cases only.
+ * It supports basic types: address, bytes, uint*, int*, bool, string
+ *
+ * For complex use cases with tuples, nested arrays, or advanced types,
+ * use viem's encodeAbiParameters instead.
+ *
+ * This function is provided to avoid bundling the entire viem library
+ * for simple encoding scenarios like encoding (address, bytes) tuples.
+ *
+ * @param types - Array of parameter types (e.g., ['address', 'bytes'])
+ * @param values - Array of values to encode
+ * @returns Hex-encoded parameters with 0x prefix
+ *
+ * @example
+ * ```typescript
+ * // Encode (address, bytes) tuple
+ * const encoded = encodeAbiParameters(
+ *   ['address', 'bytes'],
+ *   ['0x1234...', '0xabcd...']
+ * );
+ * ```
+ */
+export declare function encodeAbiParameters(types: string[], values: unknown[]): Hex;
 //# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAe,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAwCnD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASvD;AAoXD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B,GAAG,GAAG,CA+DN;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CA0CV;AAmBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACd,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,GAAG,IAAI,CA+C7C"}
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAe,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAwCnD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASvD;AAoXD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B,GAAG,GAAG,CA+DN;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CA0CV;AAmBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACd,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,GAAG,IAAI,CA+C7C;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CA+C3E"}

package/dist/abi.js

@@ -446,3 +446,68 @@ export function decodeErrorResult(config) {
     }
     return null; // No matching error found
 }
+// ============================================================================
+// SIMPLE ABI PARAMETER ENCODING (LIMITED USE CASE)
+// ============================================================================
+/**
+ * IMPORTANT: This is a lightweight encoding utility for SIMPLE cases only.
+ * It supports basic types: address, bytes, uint*, int*, bool, string
+ *
+ * For complex use cases with tuples, nested arrays, or advanced types,
+ * use viem's encodeAbiParameters instead.
+ *
+ * This function is provided to avoid bundling the entire viem library
+ * for simple encoding scenarios like encoding (address, bytes) tuples.
+ *
+ * @param types - Array of parameter types (e.g., ['address', 'bytes'])
+ * @param values - Array of values to encode
+ * @returns Hex-encoded parameters with 0x prefix
+ *
+ * @example
+ * ```typescript
+ * // Encode (address, bytes) tuple
+ * const encoded = encodeAbiParameters(
+ *   ['address', 'bytes'],
+ *   ['0x1234...', '0xabcd...']
+ * );
+ * ```
+ */
+export function encodeAbiParameters(types, values) {
+    if (types.length !== values.length) {
+        throw new Error(`Type/value length mismatch: ${types.length} types, ${values.length} values`);
+    }
+    const encodings = [];
+    const dynamicData = [];
+    const isDynamic = [];
+    // First pass: encode all parameters
+    for (let i = 0; i < types.length; i++) {
+        const type = types[i];
+        const dynamic = isDynamicType(type);
+        isDynamic.push(dynamic);
+        if (dynamic) {
+            encodings.push('');
+            dynamicData.push(encodeParam(type, values[i]));
+        }
+        else {
+            encodings.push(encodeParam(type, values[i]));
+        }
+    }
+    // Second pass: calculate offsets and build result
+    if (dynamicData.length === 0) {
+        return ('0x' + encodings.join(''));
+    }
+    let offset = encodings.reduce((sum, enc, i) => sum + (isDynamic[i] ? BYTES_PER_WORD : enc.length / 2), 0);
+    let result = '';
+    let dynamicIndex = 0;
+    for (let i = 0; i < types.length; i++) {
+        if (isDynamic[i]) {
+            result += toHex64(offset);
+            offset += dynamicData[dynamicIndex].length / 2;
+            dynamicIndex++;
+        }
+        else {
+            result += encodings[i];
+        }
+    }
+    return ('0x' + result + dynamicData.join(''));
+}

package/dist/bytes.d.ts

@@ -2,4 +2,8 @@
  * Convert a Uint8Array to a hex string with 0x prefix
  */
 export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert a hex string (with or without 0x prefix) to a Uint8Array
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
 //# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMpD"}
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CASlD"}

package/dist/bytes.js

@@ -13,3 +13,14 @@ export function bytesToHex(bytes) {
     }
     return hex;
 }
+/**
+ * Convert a hex string (with or without 0x prefix) to a Uint8Array
+ */
+export function hexToBytes(hex) {
+    const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(cleanHex.length / 2);
+    for (let i = 0; i < cleanHex.length; i += 2) {
+        bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
+    }
+    return bytes;
+}

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import type { CirclesConfig } from '@aboutcircles/sdk-types';
+/**
+ * Default Circles configurations by chain ID
+ *
+ * Chain IDs:
+ * - 100: Gnosis Chain (mainnet)
+ */
+export declare const circlesConfig: {
+    [chainId: number]: CirclesConfig;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAA;CAmB7D,CAAC"}

package/dist/config.js

@@ -0,0 +1,26 @@
+/**
+ * Default Circles configurations by chain ID
+ *
+ * Chain IDs:
+ * - 100: Gnosis Chain (mainnet)
+ */
+export const circlesConfig = {
+    100: {
+        circlesRpcUrl: "https://rpc.aboutcircles.com/",
+        pathfinderUrl: "https://pathfinder.aboutcircles.com",
+        profileServiceUrl: "https://rpc.aboutcircles.com/profiles/",
+        referralsServiceUrl: "https://staging.circlesubi.network/referrals",
+        v1HubAddress: "0x29b9a7fbb8995b2423a71cc17cf9810798f6c543",
+        v2HubAddress: "0xc12C1E50ABB450d6205Ea2C3Fa861b3B834d13e8",
+        nameRegistryAddress: "0xA27566fD89162cC3D40Cb59c87AAaA49B85F3474",
+        baseGroupMintPolicy: "0xcCa27c26CF7BAC2a9928f42201d48220F0e3a549",
+        standardTreasury: "0x08F90aB73A515308f03A718257ff9887ED330C6e",
+        coreMembersGroupDeployer: "0xFEca40Eb02FB1f4F5F795fC7a03c1A27819B1Ded",
+        baseGroupFactoryAddress: "0xD0B5Bd9962197BEaC4cbA24244ec3587f19Bd06d",
+        liftERC20Address: "0x5F99a795dD2743C36D63511f0D4bc667e6d3cDB5",
+        invitationEscrowAddress: "0x8F8B74fa13eaaff4176D061a0F98ad5c8E19c903",
+        invitationFarmAddress: "0x0000000000000000000000000000000000000000",
+        referralsModuleAddress: "0xd6dF7cc2C2DB03ec91761f4469D8dBAac7e538C9",
+        invitationModuleAddress: "0x00738aca013B7B2e6cfE1690F0021C3182Fa40B5"
+    }
+};

package/dist/constants.d.ts

@@ -6,4 +6,25 @@ import type { Address } from '@aboutcircles/sdk-types';
  * The zero address (0x0000000000000000000000000000000000000000)
  */
 export declare const ZERO_ADDRESS: Address;
+/**
+ * The invitation fee required to invite a new user (96 CRC)
+ */
+export declare const INVITATION_FEE: bigint;
+/**
+ * Maximum target flow value used for pathfinding to find the maximum possible flow
+ * This represents an extremely large number that effectively means "find max flow"
+ */
+export declare const MAX_FLOW: bigint;
+/**
+ * Safe Proxy Factory address used to deploy Safe proxies
+ */
+export declare const SAFE_PROXY_FACTORY: Address;
+/**
+ * Hash of the account initializer used in CREATE2 salt calculation
+ */
+export declare const ACCOUNT_INITIALIZER_HASH: `0x${string}`;
+/**
+ * Hash of the account creation code used in CREATE2 address calculation
+ */
+export declare const ACCOUNT_CREATION_CODE_HASH: `0x${string}`;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAAsD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,OAAsD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,cAAc,QAAgC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAkD,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAsD,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,MAAM,EAAyE,CAAC;AAE5H;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAAK,MAAM,EAAyE,CAAC"}

package/dist/constants.js

@@ -5,3 +5,24 @@
  * The zero address (0x0000000000000000000000000000000000000000)
  */
 export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/**
+ * The invitation fee required to invite a new user (96 CRC)
+ */
+export const INVITATION_FEE = BigInt(96) * BigInt(10 ** 18);
+/**
+ * Maximum target flow value used for pathfinding to find the maximum possible flow
+ * This represents an extremely large number that effectively means "find max flow"
+ */
+export const MAX_FLOW = BigInt('9999999999999999999999999999999999999');
+/**
+ * Safe Proxy Factory address used to deploy Safe proxies
+ */
+export const SAFE_PROXY_FACTORY = '0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67';
+/**
+ * Hash of the account initializer used in CREATE2 salt calculation
+ */
+export const ACCOUNT_INITIALIZER_HASH = '0x440ea2f93c9703f7d456d48796f7bc25b8721582535a492ce0a09df32146242a';
+/**
+ * Hash of the account creation code used in CREATE2 address calculation
+ */
+export const ACCOUNT_CREATION_CODE_HASH = '0xe298282cefe913ab5d282047161268a8222e4bd4ed106300c547894bbefd31ee';

package/dist/crypto.d.ts

@@ -0,0 +1,19 @@
+import type { Address, Hex } from '@aboutcircles/sdk-types';
+/**
+ * Generate a random private key (32 bytes / 64 hex chars)
+ * @returns Private key as hex string with 0x prefix
+ */
+export declare function generatePrivateKey(): Hex;
+/**
+ * Derive Ethereum address from private key
+ * @param privateKey - Private key as hex string (with or without 0x prefix)
+ * @returns Checksummed Ethereum address
+ */
+export declare function privateKeyToAddress(privateKey: string): Address;
+/**
+ * Calculate keccak256 hash of data
+ * @param data - Hex string or Uint8Array to hash
+ * @returns Hash as hex string with 0x prefix
+ */
+export declare function keccak256(data: Hex | Uint8Array): Hex;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAGxC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAe/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,GAAG,GAAG,CAYrD"}

package/dist/crypto.js

@@ -0,0 +1,45 @@
+import { secp256k1 } from '@noble/curves/secp256k1';
+import { keccak_256 } from '@noble/hashes/sha3';
+import { checksumAddress } from './abi';
+/**
+ * Generate a random private key (32 bytes / 64 hex chars)
+ * @returns Private key as hex string with 0x prefix
+ */
+export function generatePrivateKey() {
+    const privateKeyBytes = secp256k1.utils.randomPrivateKey();
+    return ('0x' + Buffer.from(privateKeyBytes).toString('hex'));
+}
+/**
+ * Derive Ethereum address from private key
+ * @param privateKey - Private key as hex string (with or without 0x prefix)
+ * @returns Checksummed Ethereum address
+ */
+export function privateKeyToAddress(privateKey) {
+    const cleanKey = privateKey.startsWith('0x') ? privateKey.slice(2) : privateKey;
+    const keyBytes = Buffer.from(cleanKey, 'hex');
+    // Get uncompressed public key (65 bytes: 0x04 + 64 bytes)
+    const publicKey = secp256k1.getPublicKey(keyBytes, false);
+    // Hash the public key (excluding the 0x04 prefix byte)
+    const hash = keccak_256(publicKey.slice(1));
+    // Take last 20 bytes as address
+    const addressBytes = hash.slice(-20);
+    const address = '0x' + Buffer.from(addressBytes).toString('hex');
+    return checksumAddress(address);
+}
+/**
+ * Calculate keccak256 hash of data
+ * @param data - Hex string or Uint8Array to hash
+ * @returns Hash as hex string with 0x prefix
+ */
+export function keccak256(data) {
+    let bytes;
+    if (typeof data === 'string') {
+        const cleanData = data.startsWith('0x') ? data.slice(2) : data;
+        bytes = Buffer.from(cleanData, 'hex');
+    }
+    else {
+        bytes = data;
+    }
+    const hash = keccak_256(bytes);
+    return ('0x' + Buffer.from(hash).toString('hex'));
+}

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export { CirclesConverter } from './circlesConverter';
-export { bytesToHex } from './bytes';
-export { encodeFunctionData, decodeFunctionResult, decodeErrorResult, checksumAddress } from './abi';
+export { bytesToHex, hexToBytes } from './bytes';
+export { encodeFunctionData, decodeFunctionResult, decodeErrorResult, checksumAddress, encodeAbiParameters } from './abi';
 export { cidV0ToHex, cidV0ToUint8Array } from './cid';
 export { uint256ToAddress } from './address';
-export { ZERO_ADDRESS } from './constants';
+export { ZERO_ADDRESS, INVITATION_FEE, MAX_FLOW, SAFE_PROXY_FACTORY, ACCOUNT_INITIALIZER_HASH, ACCOUNT_CREATION_CODE_HASH } from './constants';
+export { circlesConfig } from './config';
 export { parseContractError, ContractError } from './contractErrors';
+export { generatePrivateKey, privateKeyToAddress, keccak256 } from './crypto';
 export { CirclesError, ValidationError, EncodingError, wrapError, isCirclesError, getErrorMessage, } from './errors';
 export type { BaseErrorSource, UtilsErrorSource } from './errors';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC1H,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC/I,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}