rise-wallet 0.1.4-beta.1 → 0.2.28

package/dist/viem/Account.d.ts

@@ -0,0 +1,110 @@
+import * as Address from 'ox/Address';
+import type * as Hex from 'ox/Hex';
+import type * as WebAuthnP256 from 'ox/WebAuthnP256';
+import { type LocalAccount, type PartialBy } from 'viem';
+import type { Assign, Compute } from "../core/internal/types.js";
+import type * as Storage from "../core/Storage.js";
+import * as Key from "./Key.js";
+export type Account<source extends 'porto' | 'privateKey' = 'porto' | 'privateKey'> = LocalAccount<source> & {
+    keys?: readonly Key.Key[] | undefined;
+    sign: NonNullable<LocalAccount['sign']>;
+};
+/**
+ * Instantiates a delegated account.
+ *
+ * @param account - Account to instantiate.
+ * @returns An instantiated delegated account.
+ */
+export declare function from<const account extends from.Parameters>(parameters: from.Parameters<account>): Compute<from.ReturnType<account>>;
+export declare namespace from {
+    type AccountParameter = PartialBy<Pick<Account, 'address' | 'keys' | 'sign'>, 'sign'>;
+    type Parameters<account extends Address.Address | AccountParameter = Address.Address | AccountParameter> = account | Address.Address | AccountParameter;
+    type ReturnType<account extends Address.Address | AccountParameter = Address.Address | AccountParameter> = Readonly<Assign<Account, account extends AccountParameter ? account : {
+        address: account;
+    }> & {
+        source: account extends {
+            sign: NonNullable<LocalAccount['sign']>;
+        } ? 'privateKey' : 'porto';
+    }>;
+}
+/**
+ * Instantiates a delegated account from a private key.
+ *
+ * @param privateKey - Private key.
+ * @param options - Options.
+ * @returns An instantiated delegated account.
+ */
+export declare function fromPrivateKey<const options extends fromPrivateKey.Options = fromPrivateKey.Options>(privateKey: Hex.Hex, options?: options | fromPrivateKey.Options): Compute<fromPrivateKey.ReturnType<options>>;
+export declare namespace fromPrivateKey {
+    type Options = {
+        /**
+         * Keys to instantiate.
+         */
+        keys?: readonly Key.Key[] | undefined;
+    };
+    type ReturnType<options extends Options = Options> = Readonly<(Omit<Account, 'keys'> & (options['keys'] extends readonly Key.Key[] ? {
+        keys: options['keys'];
+    } : {
+        keys?: Account['keys'];
+    })) & {
+        source: 'privateKey';
+    }>;
+}
+export declare function getKey(account: Account, parameters?: getKey.Parameters): Key.Key | undefined;
+export declare namespace getKey {
+    type Parameters = {
+        key?: number | Key.Key | null | undefined;
+        role?: Key.Key['role'] | undefined;
+    };
+}
+/**
+ * Extracts a signing key from a delegated account and signs a payload.
+ *
+ * @example
+ * TODO
+ *
+ * @param parameters - Parameters.
+ * @returns Signature.
+ */
+export declare function sign(account: Account, parameters: sign.Parameters): Promise<Compute<Hex.Hex>>;
+export declare namespace sign {
+    type Parameters = {
+        /**
+         * Key to sign the payloads with.
+         *
+         * - If number, the key at the index will be used.
+         * - If `Key.Key`, the provided key will be used.
+         * - If `null`, the account's root signing key will be used.
+         * - If not provided, a key will be extracted from the `account`.
+         */
+        key?: number | Key.Key | null | undefined;
+        /**
+         * Payload to sign.
+         */
+        payload: Hex.Hex;
+        /**
+         * Whether to use replay-safe signing.
+         * `false` if replay-safe signing is not needed (e.g. signing call bundles).
+         */
+        replaySafe?: boolean;
+        /**
+         * Role to extract the key from the `account` for signing.
+         */
+        role?: Key.Key['role'] | undefined;
+        /**
+         * Storage to use for keytype-specific caching (e.g. WebAuthn user verification).
+         */
+        storage?: Storage.Storage | undefined;
+        /**
+         * Whether to wrap the signature with key metadata.
+         */
+        wrap?: boolean | undefined;
+        /**
+         * WebAuthn helpers for non-browser environments (e.g., React Native passkeys).
+         */
+        webAuthn?: {
+            createFn?: WebAuthnP256.createCredential.Options['createFn'] | undefined;
+            getFn?: WebAuthnP256.sign.Options['getFn'] | undefined;
+        } | undefined;
+    };
+}

package/dist/viem/Account.js

@@ -0,0 +1,132 @@
+import * as Address from 'ox/Address';
+import * as Secp256k1 from 'ox/Secp256k1';
+import * as Signature from 'ox/Signature';
+import * as TypedData from 'ox/TypedData';
+import { hashMessage, hashTypedData, } from 'viem';
+import { toAccount } from 'viem/accounts';
+import * as Key from "./Key.js";
+/**
+ * Instantiates a delegated account.
+ *
+ * @param account - Account to instantiate.
+ * @returns An instantiated delegated account.
+ */
+export function from(parameters) {
+    const account = (typeof parameters === 'string' ? { address: parameters } : parameters);
+    const source = account.sign ? 'privateKey' : 'porto';
+    const { address, sign: sign_, signMessage, signTransaction, signTypedData, type, } = toAccount({
+        address: account.address,
+        sign({ hash }) {
+            if (source === 'privateKey')
+                return account.sign({ hash });
+            throw new Error('`sign` not supported on porto accounts.');
+        },
+        signMessage({ message }) {
+            return this.sign({
+                hash: hashMessage(message),
+            });
+        },
+        signTransaction() {
+            throw new Error('`signTransaction` not supported on porto accounts.');
+        },
+        signTypedData(typedData) {
+            return this.sign({
+                hash: hashTypedData(typedData),
+            });
+        },
+    });
+    return {
+        address,
+        keys: account.keys ?? undefined,
+        sign: sign_,
+        signMessage,
+        signTransaction,
+        signTypedData,
+        source,
+        type,
+    };
+}
+/**
+ * Instantiates a delegated account from a private key.
+ *
+ * @param privateKey - Private key.
+ * @param options - Options.
+ * @returns An instantiated delegated account.
+ */
+export function fromPrivateKey(privateKey, options = {}) {
+    const { keys } = options;
+    const address = Address.fromPublicKey(Secp256k1.getPublicKey({ privateKey }));
+    return from({
+        address,
+        keys,
+        async sign({ hash }) {
+            return Signature.toHex(Secp256k1.sign({
+                payload: hash,
+                privateKey,
+            }));
+        },
+        source: 'privateKey',
+    });
+}
+export function getKey(account, parameters = {}) {
+    const { key, role } = parameters;
+    if (key === null)
+        return undefined;
+    // Extract from `key` parameter.
+    if (typeof key === 'object')
+        return key;
+    // Extract from `account.keys` (with optional `key` index).
+    if (account.keys && account.keys.length > 0) {
+        if (typeof key === 'number')
+            return account.keys[key];
+        return account.keys.find((key) => key.privateKey && (!role || key.role === role));
+    }
+    return undefined;
+}
+/**
+ * Extracts a signing key from a delegated account and signs a payload.
+ *
+ * @example
+ * TODO
+ *
+ * @param parameters - Parameters.
+ * @returns Signature.
+ */
+export async function sign(account, parameters) {
+    const { storage, replaySafe = true, wrap = true, webAuthn } = parameters;
+    const key = getKey(account, parameters);
+    const payload = (() => {
+        if (!replaySafe)
+            return parameters.payload;
+        return TypedData.getSignPayload({
+            domain: { verifyingContract: account.address },
+            message: {
+                digest: parameters.payload,
+            },
+            primaryType: 'ERC1271Sign',
+            types: {
+                ERC1271Sign: [{ name: 'digest', type: 'bytes32' }],
+            },
+        });
+    })();
+    const sign = (() => {
+        if (!key) {
+            if (account.source === 'privateKey')
+                return account.sign;
+            return undefined;
+        }
+        return ({ hash }) => Key.sign(key, {
+            address: null,
+            payload: hash,
+            storage,
+            webAuthn,
+            wrap,
+        });
+    })();
+    // If the account has no valid signing key, then we cannot sign the payload.
+    if (!sign)
+        throw new Error('cannot find key to sign with.');
+    // Sign the payload.
+    return await sign({ hash: payload });
+}
+//# sourceMappingURL=Account.js.map

package/dist/viem/Account.js.map

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

package/dist/viem/AccountActions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Porto Account Actions.
+ */
+import type { Client } from 'viem';
+import * as RpcSchema from "../core/RpcSchema.js";
+export declare function verifyEmail(client: Client, parameters: verifyEmail.Parameters): Promise<verifyEmail.ReturnType>;
+export declare namespace verifyEmail {
+    type Parameters = RpcSchema.account_verifyEmail.Parameters;
+    type ReturnType = RpcSchema.account_verifyEmail.Response;
+}

package/dist/viem/AccountActions.js

@@ -0,0 +1,14 @@
+/**
+ * Porto Account Actions.
+ */
+import * as z from 'zod/mini';
+import * as RpcSchema from "../core/RpcSchema.js";
+export async function verifyEmail(client, parameters) {
+    const method = 'account_verifyEmail';
+    const response = await client.request({
+        method,
+        params: [z.encode(RpcSchema.account_verifyEmail.Parameters, parameters)],
+    });
+    return z.decode(RpcSchema.account_verifyEmail.Response, response);
+}
+//# sourceMappingURL=AccountActions.js.map

package/dist/viem/AccountActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountActions.js","sourceRoot":"","sources":["../../src/viem/AccountActions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAC7B,OAAO,KAAK,SAAS,6BAA4B;AAGjD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,UAAkC;IAElC,MAAM,MAAM,GAAG,qBAA8B,CAAA;IAE7C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAEnC;QACA,MAAM;QACN,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;KACzE,CAAC,CAAA;IAEF,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AACnE,CAAC"}

package/dist/viem/CapabilitiesSchema.d.ts

@@ -0,0 +1,14 @@
+import type { ValueOf } from 'viem';
+import type * as Rpc from "../core/internal/schema/rpc.js";
+export type CapabilitiesSchema = {
+    connect: {
+        Request: Pick<Rpc.wallet_connect.Capabilities, 'grantPermissions'>;
+        Response: Pick<Rpc.wallet_connect.ResponseCapabilities, 'permissions'>;
+    };
+    getCapabilities: {
+        Response: ValueOf<Rpc.wallet_getCapabilities.Response>;
+    };
+    sendCalls: {
+        Request: Pick<Rpc.wallet_prepareCalls.Capabilities, 'feeToken' | 'permissions' | 'merchantUrl'>;
+    };
+};

package/dist/viem/CapabilitiesSchema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CapabilitiesSchema.js.map

package/dist/viem/CapabilitiesSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilitiesSchema.js","sourceRoot":"","sources":["../../src/viem/CapabilitiesSchema.ts"],"names":[],"mappings":""}

package/dist/viem/ContractActions.d.ts

@@ -0,0 +1,208 @@
+import * as AbiError from 'ox/AbiError';
+import type * as Address from 'ox/Address';
+import * as Errors from 'ox/Errors';
+import * as Hex from 'ox/Hex';
+import * as TypedData from 'ox/TypedData';
+import { type Account as Account_viem, type Authorization as Authorization_viem, BaseError, type Chain, type Client, type Transport } from 'viem';
+import { type EncodeExecuteDataParameters } from 'viem/experimental/erc7821';
+import type { OneOf } from "../core/internal/types.js";
+import type * as Storage from "../core/Storage.js";
+import * as Account from "./Account.js";
+import type { GetAccountParameter } from "./internal/utils.js";
+import * as Key from "./Key.js";
+export { abi, code, } from "../core/internal/_generated/contracts/IthacaAccount.js";
+/**
+ * Executes a set of calls on a delegated account.
+ *
+ * @example
+ * TODO
+ *
+ * @param client - Client.
+ * @param parameters - Execution parameters.
+ * @returns Transaction hash.
+ */
+export declare function execute<const calls extends readonly unknown[], chain extends Chain | undefined, account extends Account.Account | undefined>(client: Client<Transport, chain, account>, parameters: execute.Parameters<calls, account>): Promise<execute.ReturnType>;
+export declare namespace execute {
+    type Parameters<calls extends readonly unknown[] = readonly unknown[], account extends Account.Account | undefined = Account.Account | undefined> = Pick<EncodeExecuteDataParameters<calls>, 'calls'> & GetAccountParameter<account> & {
+        /**
+         * Contract address to delegate to.
+         */
+        delegation?: Address.Address | undefined;
+        /**
+         * The executor of the execute transaction.
+         *
+         * - `Account`: execution will be attempted with the specified account.
+         * - `undefined`: the transaction will be filled by the JSON-RPC server.
+         */
+        executor?: Account_viem | undefined;
+        /**
+         * Storage to use for keytype-specific caching (e.g. WebAuthn user verification).
+         */
+        storage?: Storage.Storage | undefined;
+    } & OneOf<{
+        /**
+         * EIP-7702 Authorization to use for delegation.
+         */
+        authorization?: Authorization_viem | undefined;
+        /**
+         * Nonce to use for execution that will be invalidated by the delegated account.
+         */
+        nonce: bigint;
+        /**
+         * Signature for execution. Required if the `executor` is not the EOA.
+         */
+        signatures: {
+            auth?: Hex.Hex | undefined;
+            exec: Hex.Hex;
+        };
+    } | {
+        /**
+         * Key to use for execution.
+         */
+        key?: number | Key.Key | undefined;
+    } | {}>;
+    type ReturnType = Hex.Hex;
+}
+/**
+ * Returns the EIP-712 domain for a delegated account. Used for the execution
+ * signing payload.
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns EIP-712 domain.
+ */
+export declare function getEip712Domain<chain extends Chain | undefined, account extends Account.Account | undefined>(client: Client<Transport, chain, account>, parameters: getEip712Domain.Parameters<account>): Promise<TypedData.Domain>;
+export declare namespace getEip712Domain {
+    type Parameters<account extends Account.Account | undefined = Account.Account | undefined> = GetAccountParameter<account>;
+}
+/**
+ * Returns the key at the given index.
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns Key.
+ */
+export declare function keyAt<chain extends Chain | undefined, account extends Account.Account | undefined>(client: Client<Transport, chain, account>, parameters: keyAt.Parameters<account>): Promise<Key.Key>;
+export declare namespace keyAt {
+    type Parameters<account extends Account.Account | undefined = Account.Account | undefined> = GetAccountParameter<account> & {
+        /**
+         * Index of the key to extract.
+         */
+        index: number;
+    };
+}
+/**
+ * Prepares the payloads to sign over and fills the request to execute a set of calls.
+ *
+ * @example
+ * TODO
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns Prepared properties.
+ */
+export declare function prepareExecute<const calls extends readonly unknown[], chain extends Chain | undefined, account extends Account.Account | undefined>(client: Client<Transport, chain, account>, parameters: prepareExecute.Parameters<calls, account>): Promise<prepareExecute.ReturnType<calls>>;
+export declare namespace prepareExecute {
+    type Parameters<calls extends readonly unknown[] = readonly unknown[], account extends Account.Account | undefined = Account.Account | undefined> = Pick<execute.Parameters<calls, account>, 'calls'> & GetAccountParameter<account> & {
+        /**
+         * Contract address to delegate to.
+         */
+        delegation?: Address.Address | undefined;
+        /**
+         * The executor of the execute transaction.
+         *
+         * - `Account`: execution will be attempted with the specified account.
+         * - `undefined`: the transaction will be filled by the JSON-RPC server.
+         */
+        executor?: Account_viem | undefined;
+    };
+    type ReturnType<calls extends readonly unknown[] = readonly unknown[]> = {
+        digests: {
+            auth?: Hex.Hex | undefined;
+            exec: Hex.Hex;
+        };
+        request: Omit<Parameters<calls>, 'account' | 'delegation'> & {
+            account: Account.Account;
+            authorization?: Authorization_viem | undefined;
+            nonce: bigint;
+        };
+        typedData: TypedData.Definition;
+    };
+}
+export declare function parseExecutionError<const calls extends readonly unknown[]>(e: unknown, { calls }?: {
+    calls?: execute.Parameters<calls>['calls'] | undefined;
+}): void;
+export declare namespace parseExecutionError {
+    type ErrorType = ExecutionError | Errors.GlobalErrorType;
+}
+/** Thrown when the execution fails. */
+export declare class ExecutionError extends Errors.BaseError<BaseError> {
+    readonly name = "AccountContract.ExecutionError";
+    abiError?: AbiError.AbiError | undefined;
+    constructor(cause: BaseError & {
+        abiError?: AbiError.AbiError | undefined;
+    });
+}
+export type Decorator<account extends Account.Account | undefined = Account.Account | undefined> = {
+    /**
+     * Executes a set of calls on a delegated account.
+     *
+     * @example
+     * TODO
+     *
+     * @param client - Client.
+     * @param parameters - Execution parameters.
+     * @returns Transaction hash.
+     */
+    execute: <const calls extends readonly unknown[]>(parameters: execute.Parameters<calls, account>) => Promise<execute.ReturnType>;
+    /**
+     * Returns the EIP-712 domain for a delegated account. Used for the execution
+     * signing payload.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns EIP-712 domain.
+     */
+    getEip712Domain: (parameters: getEip712Domain.Parameters<account>) => Promise<TypedData.Domain>;
+    /**
+     * Returns the key at the given index.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns Key.
+     */
+    keyAt: (parameters: keyAt.Parameters<account>) => Promise<Key.Key>;
+    /**
+     * Prepares the payloads to sign over and fills the request to execute a set of calls.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns Prepared properties.
+     */
+    prepareExecute: <calls extends readonly unknown[] = readonly unknown[]>(parameters: prepareExecute.Parameters<calls, account>) => Promise<prepareExecute.ReturnType<calls>>;
+};
+export declare function decorator<transport extends Transport, chain extends Chain | undefined, account extends Account.Account | undefined>(client: Client<transport, chain, account>): Decorator<account>;
+export declare namespace getExecuteDigest {
+    type Parameters<calls extends readonly unknown[] = readonly unknown[]> = {
+        /**
+         * The delegated account to execute the calls on.
+         */
+        account: Account.Account;
+        /**
+         * Contract address to delegate to.
+         */
+        delegation?: Address.Address | undefined;
+        /**
+         * Calls to execute.
+         */
+        calls: calls;
+        /**
+         * Nonce to use for execution that will be invalidated by the delegated account.
+         */
+        nonce: bigint;
+        /**
+         * Nonce salt.
+         */
+        nonceSalt?: bigint | undefined;
+    };
+}