@rhinestone/sdk 0.0.0-dev-20260914125047 → 0.0.0-dev-20260914125455

package/README.md

@@ -127,14 +127,32 @@ Create a smart account:
 import { RhinestoneSDK } from '@rhinestone/sdk'
 
 const rhinestone = new RhinestoneSDK({ apiKey: 'your-api-key' })
-const account = await rhinestone.createAccount({
+const evmConfig = {
   owners: {
-    type: 'ecdsa',
+    type: 'ecdsa' as const,
     accounts: [signer],
   },
+}
+const account = await rhinestone.createAccount({ evm: evmConfig })
+
+const address = account.getAddress('evm')
+```
+
+Add an address-only Solana destination when you need to receive tokens there:
+
+```ts
+import { solanaAddress } from '@rhinestone/sdk'
+
+const crossVmAccount = await rhinestone.createAccount({
+  evm: evmConfig,
+  solana: { address: solanaAddress(existingSolanaAddress) },
 })
 ```
 
+Address-only entries cannot prepare, sign, or execute transactions. Managed
+Solana configuration is reserved for a future release and currently fails during
+account construction; Solana destinations are token-delivery only.
+
 Send a crosschain transaction:
 
 ```ts

package/dist/src/actions/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../actions/runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,OAAO,EACR,MAAM,mBAAmB,CAAA;AAU1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAyEtD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,SAAS,EAAE,KAAK,MAAM,EAAE,GACvB,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAW3E;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,SAAS,EAAE,KAAK,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4C1B;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBzB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../actions/runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,OAAO,EACR,MAAM,mBAAmB,CAAA;AAU1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AA4EtD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,SAAS,EAAE,KAAK,MAAM,EAAE,GACvB,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAW3E;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,KAAK,MAAM,EAAE,EACtB,SAAS,EAAE,KAAK,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4C1B;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBzB"}

package/dist/src/api/account.d.ts

@@ -1,8 +1,8 @@
 import type { Address, Chain, HashTypedDataParameters, Hex, SignableMessage, SignedAuthorizationList, TypedData, TypedDataDefinition } from 'viem';
 import type { UserOperationReceipt } from 'viem/account-abstraction';
-import type { DestinationChain } from '../chains/non-evm.js';
+import { type DestinationChain, type SolanaAddress } from '../chains/non-evm.js';
 import type { HyperCoreAction, OriginSignature, Portfolio, SignData } from '../clients/orchestrator/public.js';
-import type { RhinestoneAccountConfig, Session, SignerSet, Transaction, UserOperationTransaction } from '../config/account.js';
+import type { AccountTransaction, EvmAccountConfig, RhinestoneAccountConfig, Session, SignerSet, SolanaManagedAccountConfig, Transaction, UserOperationTransaction } from '../config/account.js';
 import type { LegacyAccountConfig } from '../config/legacy.js';
 import type { AccountInvocationContext } from '../config/resolved.js';
 import type { SessionDetails } from '../modules/validators/smart-sessions/types.js';
@@ -25,56 +25,39 @@ export interface SignedIntentData {
     targetExecutionSignature: Hex | undefined;
 }
 type Compat = LegacyAccountConfig<unknown>;
-/**
- * The account facade. Mirrors the published `RhinestoneAccount` surface, but
- * every method materializes a fresh invocation context from the retained
- * mutable compatibility config and delegates to the SDK-core composition.
- */
-export interface RhinestoneAccount {
-    /** The resolved account configuration. */
-    config: RhinestoneAccountConfig;
+type AccountVm = 'evm' | 'solana';
+type DefaultAccountConfig = Readonly<{
+    evm: EvmAccountConfig;
+}>;
+type ConfiguredVm<C> = Extract<keyof C, AccountVm>;
+type NativeAddress<Vm extends AccountVm> = Vm extends 'evm' ? Address : SolanaAddress;
+type RequiredBranch<C, Vm extends AccountVm> = [C] extends [
+    Readonly<Record<Vm, infer Branch>>
+] ? Branch : never;
+type HasManagedEvm<C> = [RequiredBranch<C, 'evm'>] extends [never] ? false : [RequiredBranch<C, 'evm'>] extends [EvmAccountConfig] ? true : false;
+type HasManagedSolana<C> = [RequiredBranch<C, 'solana'>] extends [never] ? false : [RequiredBranch<C, 'solana'>] extends [SolanaManagedAccountConfig] ? true : false;
+/** Address access shared by every account handle. */
+export interface RhinestoneAccountBase<C extends RhinestoneAccountConfig = DefaultAccountConfig> {
+    /** Captured composite configuration. VM membership is shallowly immutable. */
+    config: Readonly<C>;
     /**
-     * Deploy the account on a given chain.
-     * @param chain Chain to deploy the account on
-     * @param params Optional deployment parameters (sponsorship)
-     * @returns `true` once the deployment is submitted
-     */
-    deploy(chain: Chain, params?: {
-        sponsored?: boolean;
-    }): Promise<boolean>;
-    /**
-     * Check whether the account is deployed on a given chain.
-     * @param chain Chain to check
-     * @returns `true` if the account is deployed, `false` otherwise
-     */
-    isDeployed(chain: Chain): Promise<boolean>;
-    /**
-     * Set up an existing account on a given chain by installing any missing modules.
-     * @param chain Chain to set the account up on
-     * @returns `true` once setup is submitted
-     */
-    setup(chain: Chain): Promise<boolean>;
-    /**
-     * Get the account initialization data, used to deploy the account onchain.
-     * @returns The factory address and factory data
+     * Get the native address for a configured VM.
+     * @param vm Configured VM to read
+     * @returns The account or receiver address in that VM's native format
+     * @throws AccountVmNotConfiguredError when a widened input names an absent VM
      */
-    getInitData(): {
-        factory: Address;
-        factoryData: Hex;
-    };
-    /**
-     * Prepare and sign the EIP-7702 account initialization data.
-     * @returns The init data signature
-     */
-    signEip7702InitData(): Promise<Hex>;
+    getAddress<const Vm extends ConfiguredVm<C>>(vm: Vm): C extends Readonly<Record<Vm, unknown>> ? NativeAddress<Vm> : NativeAddress<Vm> | undefined;
+}
+/** Intent transaction lifecycle exposed by accounts with a managed source. */
+export interface ManagedTransactionAccount<_C extends RhinestoneAccountConfig = DefaultAccountConfig> {
     /**
-     * Prepare a transaction for signing.
+     * Prepare an intent transaction for signing.
      * @param transaction Transaction to prepare
      * @returns The prepared transaction data
      * @see {@link signTransaction} to sign the prepared transaction
      * @see {@link submitTransaction} to submit the signed transaction
      */
-    prepareTransaction(transaction: Transaction): Promise<PreparedTransactionData>;
+    prepareTransaction(transaction: AccountTransaction<_C>): Promise<PreparedTransactionData>;
     /**
      * Get the typed-data messages to sign for a prepared transaction.
      * @param preparedTransaction Prepared transaction data
@@ -126,6 +109,57 @@ export interface RhinestoneAccount {
      * @see {@link prepareTransaction} to prepare the transaction data for signing
      */
     signAuthorizations(preparedTransaction: PreparedTransactionData): Promise<SignedAuthorizationList>;
+    /**
+     * Submit a signed transaction.
+     * @param signedTransaction Signed transaction data
+     * @param options Optional submission options (e.g. EIP-7702 `authorizations`)
+     * @returns The transaction result (an intent ID)
+     * @see {@link signTransaction} to sign the transaction data
+     * @see {@link signAuthorizations} to sign the required EIP-7702 authorizations
+     * @see {@link waitForExecution} to wait for the transaction to execute onchain
+     */
+    submitTransaction(signedTransaction: SignedTransactionData, options?: SubmitTransactionOptions): Promise<TransactionResult>;
+    /** Wait for a submitted intent to reach a terminal state. */
+    waitForExecution(result: TransactionResult): Promise<TransactionStatus>;
+}
+/** Full EVM management, signing, UserOperation and account-read capabilities. */
+export interface ManagedEvmAccount<C extends RhinestoneAccountConfig = DefaultAccountConfig> extends ManagedTransactionAccount<C> {
+    /** The captured composite account configuration. */
+    config: Readonly<C>;
+    /**
+     * Deploy the account on a given chain.
+     * @param chain Chain to deploy the account on
+     * @param params Optional deployment parameters (sponsorship)
+     * @returns `true` once the deployment is submitted
+     */
+    deploy(chain: Chain, params?: {
+        sponsored?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Check whether the account is deployed on a given chain.
+     * @param chain Chain to check
+     * @returns `true` if the account is deployed, `false` otherwise
+     */
+    isDeployed(chain: Chain): Promise<boolean>;
+    /**
+     * Set up an existing account on a given chain by installing any missing modules.
+     * @param chain Chain to set the account up on
+     * @returns `true` once setup is submitted
+     */
+    setup(chain: Chain): Promise<boolean>;
+    /**
+     * Get the account initialization data, used to deploy the account onchain.
+     * @returns The factory address and factory data
+     */
+    getInitData(): {
+        factory: Address;
+        factoryData: Hex;
+    };
+    /**
+     * Prepare and sign the EIP-7702 account initialization data.
+     * @returns The init data signature
+     */
+    signEip7702InitData(): Promise<Hex>;
     /**
      * Sign a message (EIP-191).
      * @param message Message to sign
@@ -155,16 +189,6 @@ export interface RhinestoneAccount {
      * @see {@link signTransaction} for the canonical signing path
      */
     signIntent(signData: SignData, targetChain: DestinationChain, signers?: SignerSet): Promise<SignedIntentData>;
-    /**
-     * Submit a signed transaction.
-     * @param signedTransaction Signed transaction data
-     * @param options Optional submission options (e.g. EIP-7702 `authorizations`)
-     * @returns The transaction result (an intent ID)
-     * @see {@link signTransaction} to sign the transaction data
-     * @see {@link signAuthorizations} to sign the required EIP-7702 authorizations
-     * @see {@link waitForExecution} to wait for the transaction to execute onchain
-     */
-    submitTransaction(signedTransaction: SignedTransactionData, options?: SubmitTransactionOptions): Promise<TransactionResult>;
     /**
      * Prepare a user operation for signing.
      * @param transaction User operation to prepare
@@ -212,10 +236,12 @@ export interface RhinestoneAccount {
     waitForExecution(result: TransactionResult): Promise<TransactionStatus>;
     waitForExecution(result: UserOperationResult): Promise<UserOperationReceipt>;
     /**
-     * Get the account address.
-     * @returns The smart account address
+     * Get the native address for a configured VM.
+     * @param vm Configured VM to read
+     * @returns The account or receiver address in that VM's native format
+     * @throws AccountVmNotConfiguredError when a widened input names an absent VM
      */
-    getAddress(): Address;
+    getAddress<const Vm extends ConfiguredVm<C>>(vm: Vm): C extends Readonly<Record<Vm, unknown>> ? NativeAddress<Vm> : NativeAddress<Vm> | undefined;
     /**
      * Get the account portfolio (token balances across chains).
      * @param onTestnets Whether to query testnet balances (default is `false`)
@@ -263,8 +289,11 @@ export interface RhinestoneAccount {
      */
     getExecutors(chain: Chain): Promise<Address[]>;
 }
-export declare function createAccountFacade(compatibilityConfig: LegacyAccountConfig<unknown>, composition: CoreComposition<LegacyAccountConfig<unknown>>): RhinestoneAccount;
-export declare function adaptTransaction(context: AccountInvocationContext<Compat>, transaction: Transaction, hyperCoreAction?: HyperCoreAction): IntentInput;
+/** Account handle whose methods reflect the definitely configured capabilities. */
+export type RhinestoneAccount<C extends RhinestoneAccountConfig = DefaultAccountConfig> = RhinestoneAccountBase<C> & (HasManagedEvm<C> extends true ? ManagedEvmAccount<C> : HasManagedSolana<C> extends true ? ManagedTransactionAccount<C> : Readonly<Record<never, never>>);
+export declare function createAccountFacade<C extends RhinestoneAccountConfig>(compatibilityConfig: LegacyAccountConfig<unknown>, publicConfig: Readonly<C>, composition: CoreComposition<LegacyAccountConfig<unknown>>): ManagedEvmAccount<C>;
+export declare function normalizeTransaction(transaction: Transaction, config: Readonly<RhinestoneAccountConfig>): Transaction;
+export declare function adaptTransaction(context: AccountInvocationContext<Compat>, transaction: Transaction, hyperCoreAction?: HyperCoreAction, automaticSourceChainIds?: readonly number[]): IntentInput;
 export declare function authorizationChains(input: IntentInput): readonly IntentInput['destination'][];
 export {};
 //# sourceMappingURL=account.d.ts.map

package/dist/src/api/account.d.ts.map

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

package/dist/src/api/account.js

@@ -1,8 +1,10 @@
-import { parseCaip2, toEvmChainReference } from '../chains/caip2.js';
+import { formatCaip2, parseCaip2, toEvmChainReference } from '../chains/caip2.js';
 import { getChainById, getChainReference } from '../chains/catalog.js';
+import { solanaAddress, } from '../chains/non-evm.js';
 import { normalizeTokenAddress, validateTokenAddresses } from '../chains/tokens.js';
 import { createStaticAccountRuntime } from '../config/account-runtime.js';
 import { materializeAccountInvocationContext, resolveAccountConfig, } from '../config/resolve.js';
+import { AccountVmNotConfiguredError, UnsupportedAccountCapabilityError, } from '../errors/capability.js';
 import { IndependentSigningNotSupportedError, MismatchedOwnerSignaturesError, QuoteNotInPreparedTransactionError, } from '../errors/execution.js';
 import { resolveHyperCoreAction } from '../hypercore/resolve.js';
 import { ecdsaSignerId, webauthnSignerId, } from '../modules/validators/signer-id.js';
@@ -87,7 +89,7 @@ function referenceChain() {
     // needs some EVM chain reference. With no bundled chain set, use mainnet.
     return toEvmChainReference(1);
 }
-export function createAccountFacade(compatibilityConfig, composition) {
+export function createAccountFacade(compatibilityConfig, publicConfig, composition) {
     // Intent identity caches are facade-scoped. Values crossing account/SDK
     // instances are reconstructed and validated by the receiving account.
     const preparedIntents = new WeakMap();
@@ -95,13 +97,15 @@ export function createAccountFacade(compatibilityConfig, composition) {
     const context = (method) => materializeAccountInvocationContext(composition.config, compatibilityConfig, method);
     const workflowsFor = (ctx) => composition.createAccount(ctx).workflows;
     const resolvePrepared = (ctx, prepared, intentId) => {
+        assertSupportedTransaction(prepared.transaction, publicConfig);
+        assertSupportedSignData(selectedPublicQuote(prepared, intentId).signData);
         const cached = preparedIntents.get(prepared);
         if (cached && !intentId)
             return Promise.resolve(cached);
         return workflowsFor(ctx).reconstructPreparedIntent(ctx, reconstructInput(ctx, prepared, intentId));
     };
     const account = {
-        config: compatibilityConfig,
+        config: publicConfig,
         deploy(chain, params) {
             const ctx = context('deploy');
             return workflowsFor(ctx).deploy(ctx, toEvmChainReference(chain.id), {
@@ -129,18 +133,29 @@ export function createAccountFacade(compatibilityConfig, composition) {
         },
         async prepareTransaction(transaction) {
             const ctx = context('prepare-intent');
+            const normalized = normalizeTransaction(transaction, publicConfig);
             // Before the quote, not after: the quote's `signData` registers an agent
             // derived from the action's bytes, so the action has to be concrete here.
             const hyperCoreAction = await resolveHyperCoreAction({
-                options: transaction.hyperCore,
-                account: account.getAddress(),
+                options: normalized.hyperCore,
+                account: workflowsFor(ctx).getAddress(ctx, referenceChain()),
                 ...(ctx.sdk.hyperliquid ? { hyperliquid: ctx.sdk.hyperliquid } : {}),
             });
-            const prepared = await workflowsFor(ctx).prepareIntent(ctx, adaptTransaction(ctx, transaction, hyperCoreAction));
-            return toPreparedTransactionData(prepared, transaction, preparedIntents);
+            const automaticSources = 'targetChain' in normalized &&
+                normalized.targetChain !== undefined &&
+                normalized.sourceChains === undefined
+                ? await workflowsFor(ctx).getEligibleEvmSourceChains(destinationChainReference(normalized.targetChain))
+                : undefined;
+            if (automaticSources && automaticSources.length === 0) {
+                throw new UnsupportedAccountCapabilityError('No managed EVM source chains are eligible for this destination.');
+            }
+            const prepared = await workflowsFor(ctx).prepareIntent(ctx, adaptTransaction(ctx, normalized, hyperCoreAction, automaticSources?.map(({ id }) => id)));
+            return toPreparedTransactionData(prepared, normalized, preparedIntents);
         },
         getTransactionMessages(preparedTransaction, options) {
+            assertSupportedTransaction(preparedTransaction.transaction, publicConfig);
             const quote = selectedPublicQuote(preparedTransaction, options?.intentId);
+            assertSupportedSignData(quote.signData);
             return {
                 origin: [...quote.signData.origin],
                 destination: quote.signData.destination,
@@ -149,7 +164,7 @@ export function createAccountFacade(compatibilityConfig, composition) {
                     : {}),
             };
         },
-        signTransaction: ((preparedTransaction, options) => {
+        signTransaction: (async (preparedTransaction, options) => {
             const ctx = context('sign-intent');
             const workflows = workflowsFor(ctx);
             if (options && 'owner' in options) {
@@ -157,19 +172,20 @@ export function createAccountFacade(compatibilityConfig, composition) {
                 // reject before resolving sessions (which would issue an RPC read),
                 // matching the legacy fast-fail.
                 if (preparedTransaction.transaction.signers?.type === 'session') {
-                    return Promise.reject(new IndependentSigningNotSupportedError());
+                    throw new IndependentSigningNotSupportedError();
                 }
                 const signerId = signerIdForOwner(options.owner);
-                return resolvePrepared(ctx, preparedTransaction, options.intentId).then((internal) => workflows.signIntentAsOwner(ctx, internal, {
+                const internal = await resolvePrepared(ctx, preparedTransaction, options.intentId);
+                return workflows.signIntentAsOwner(ctx, internal, {
                     signerId,
                     ...(options.validatorId === undefined
                         ? {}
                         : { validatorId: options.validatorId }),
-                }));
+                });
             }
-            return resolvePrepared(ctx, preparedTransaction, options?.intentId)
-                .then((internal) => workflows.signIntent(ctx, internal))
-                .then(({ intent }) => toSignedTransactionData(preparedTransaction, intent, signedIntents));
+            const internal = await resolvePrepared(ctx, preparedTransaction, options?.intentId);
+            const { intent } = await workflows.signIntent(ctx, internal);
+            return toSignedTransactionData(preparedTransaction, intent, signedIntents);
         }),
         async assembleTransaction(preparedTransaction, signatures) {
             const ctx = context('assemble-intent');
@@ -183,6 +199,7 @@ export function createAccountFacade(compatibilityConfig, composition) {
             return toSignedTransactionData(preparedTransaction, signed, signedIntents);
         },
         async signAuthorizations(preparedTransaction) {
+            assertSupportedTransaction(preparedTransaction.transaction, publicConfig);
             const ctx = context('sign-authorizations');
             const intentInput = adaptTransaction(ctx, preparedTransaction.transaction);
             const chains = authorizationChains(intentInput);
@@ -217,6 +234,7 @@ export function createAccountFacade(compatibilityConfig, composition) {
             return result.signature;
         },
         async signIntent(signData, targetChain, signers) {
+            assertSupportedSignData(signData);
             const ctx = context('sign-intent');
             const result = await workflowsFor(ctx).signIntentFromSignData(ctx, {
                 signData: {
@@ -238,6 +256,8 @@ export function createAccountFacade(compatibilityConfig, composition) {
             };
         },
         async submitTransaction(signedTransaction, options) {
+            assertSupportedTransaction(signedTransaction.transaction, publicConfig);
+            assertSupportedSignData(signedTransaction.quote.signData);
             const ctx = context('submit-intent');
             const workflows = workflowsFor(ctx);
             // Fast path for the same-instance signed object; otherwise (cross-instance
@@ -361,10 +381,21 @@ export function createAccountFacade(compatibilityConfig, composition) {
             })
                 .then((status) => status.receipt);
         }),
-        getAddress() {
+        getAddress: ((vm) => {
+            if (vm === 'solana') {
+                if (publicConfig.solana &&
+                    'address' in publicConfig.solana &&
+                    publicConfig.solana.address) {
+                    return publicConfig.solana.address;
+                }
+                throw new AccountVmNotConfiguredError('solana');
+            }
+            if (vm !== 'evm' || !publicConfig.evm) {
+                throw new AccountVmNotConfiguredError(String(vm));
+            }
             const ctx = context('get-address');
             return workflowsFor(ctx).getAddress(ctx, referenceChain());
-        },
+        }),
         getPortfolio(onTestnets = false) {
             const ctx = context('get-portfolio');
             return workflowsFor(ctx)
@@ -533,6 +564,140 @@ chainIds) {
  * authorise. With no session scope there is nothing to narrow against and the
  * explicit filter stands on its own.
  */
+function assertSupportedSignData(signData) {
+    const payloads = [
+        ...signData.origin,
+        signData.destination,
+        ...(signData.targetExecution ? [signData.targetExecution] : []),
+    ];
+    for (const payload of payloads) {
+        if (!payload ||
+            typeof payload !== 'object' ||
+            typeof payload.primaryType !== 'string' ||
+            !payload.domain ||
+            typeof payload.types !== 'object' ||
+            typeof payload.message !== 'object') {
+            throw new UnsupportedAccountCapabilityError('Only EIP-712 intent signing data is supported by this account.', { capability: 'intent-signing' });
+        }
+    }
+}
+function assertSupportedTransaction(transaction, config) {
+    const input = transaction;
+    const hasChain = Object.hasOwn(input, 'chain') && input.chain !== undefined;
+    const hasTarget = Object.hasOwn(input, 'targetChain') && input.targetChain !== undefined;
+    if (hasChain === hasTarget) {
+        throw new UnsupportedAccountCapabilityError('A transaction must set exactly one of `chain` or `targetChain`.');
+    }
+    if (hasChain && typeof input.chain === 'object' && input.chain !== null) {
+        const chain = input.chain;
+        if (chain.kind === 'svm') {
+            throw new UnsupportedAccountCapabilityError('Solana-origin execution is not supported yet. Use a managed EVM source for token delivery to Solana.', { vm: 'solana' });
+        }
+    }
+    if (hasTarget && typeof input.targetChain === 'object' && input.targetChain) {
+        const target = input.targetChain;
+        if (!('kind' in target || 'caip2' in target) &&
+            (typeof target.id !== 'number' ||
+                !Number.isSafeInteger(target.id) ||
+                target.id < 0 ||
+                !formatCaip2(target.id).startsWith('eip155:'))) {
+            throw new UnsupportedAccountCapabilityError('A viem EVM destination must use an eip155 chain ID.');
+        }
+        if (('kind' in target || 'caip2' in target) &&
+            !((target.kind === 'svm' &&
+                typeof target.caip2 === 'string' &&
+                target.caip2.startsWith('solana:')) ||
+                (target.kind === 'tvm' &&
+                    typeof target.caip2 === 'string' &&
+                    target.caip2.startsWith('tron:')) ||
+                (target.kind === 'stellar' &&
+                    typeof target.caip2 === 'string' &&
+                    target.caip2.startsWith('stellar:')) ||
+                (target.kind === 'hypercore' &&
+                    (target.caip2 === 'hypercore:spot' ||
+                        target.caip2 === 'hypercore:perp')))) {
+            throw new UnsupportedAccountCapabilityError('The destination chain descriptor has mismatched VM and CAIP-2 fields.');
+        }
+        if (target.kind === 'svm') {
+            if (!Array.isArray(input.tokenRequests) ||
+                input.tokenRequests.length === 0) {
+                throw new UnsupportedAccountCapabilityError('Solana destinations require at least one token request.', { vm: 'solana' });
+            }
+            for (const request of input.tokenRequests) {
+                if (typeof request.address !== 'string') {
+                    throw new UnsupportedAccountCapabilityError('Solana token requests require a Solana address.');
+                }
+                solanaAddress(request.address);
+                if (request.amount !== undefined &&
+                    (typeof request.amount !== 'bigint' || request.amount <= 0n)) {
+                    throw new UnsupportedAccountCapabilityError('Solana token request amounts must be positive.');
+                }
+            }
+            if (typeof input.recipient === 'string')
+                solanaAddress(input.recipient);
+            if (input.calls !== undefined || input.instructions !== undefined) {
+                throw new UnsupportedAccountCapabilityError('Solana destinations support token delivery only; calls and custom instructions are unavailable.', { vm: 'solana' });
+            }
+            if (input.recipient === undefined && !config.solana) {
+                throw new AccountVmNotConfiguredError('solana');
+            }
+        }
+    }
+    if (input.sourceChains !== undefined) {
+        if (!Array.isArray(input.sourceChains)) {
+            throw new UnsupportedAccountCapabilityError('`sourceChains` must be an array of managed source chains.');
+        }
+        if (input.sourceChains.length === 0) {
+            throw new UnsupportedAccountCapabilityError('`sourceChains` must contain at least one managed source.');
+        }
+        const ids = input.sourceChains.map((value) => typeof value === 'object' && value
+            ? value.id
+            : null);
+        const invalidSource = input.sourceChains.some((value) => {
+            if (!value || typeof value !== 'object')
+                return true;
+            const source = value;
+            return (typeof source.id !== 'number' ||
+                !Number.isSafeInteger(source.id) ||
+                source.id < 0 ||
+                Object.hasOwn(source, 'kind') ||
+                Object.hasOwn(source, 'caip2') ||
+                !formatCaip2(source.id).startsWith('eip155:'));
+        });
+        if (invalidSource) {
+            throw new UnsupportedAccountCapabilityError('Only viem EVM chains from the managed EVM account can be used as sources.');
+        }
+        if (new Set(ids).size !== ids.length) {
+            throw new UnsupportedAccountCapabilityError('`sourceChains` cannot contain duplicate chains.');
+        }
+    }
+    const calls = input.calls;
+    if (input.recipient !== undefined) {
+        if (Array.isArray(calls) && calls.length > 0) {
+            throw new UnsupportedAccountCapabilityError('An explicit delivery recipient cannot execute destination calls. Omit `recipient` to execute with the invoking managed EVM account.');
+        }
+        if (!Array.isArray(input.tokenRequests) ||
+            input.tokenRequests.length === 0) {
+            throw new UnsupportedAccountCapabilityError('An explicit delivery recipient requires at least one token request.');
+        }
+    }
+}
+export function normalizeTransaction(transaction, config) {
+    assertSupportedTransaction(transaction, config);
+    if ('targetChain' in transaction &&
+        transaction.targetChain !== undefined &&
+        'kind' in transaction.targetChain &&
+        transaction.targetChain.kind === 'svm' &&
+        transaction.recipient === undefined &&
+        config.solana &&
+        'address' in config.solana) {
+        return Object.freeze({
+            ...transaction,
+            recipient: config.solana.address,
+        });
+    }
+    return Object.freeze({ ...transaction });
+}
 function narrowQuoterPin(derived, explicit) {
     if (!explicit)
         return derived;
@@ -544,7 +709,10 @@ function narrowQuoterPin(derived, explicit) {
         : derived.include.filter((quoter) => !explicit.exclude.includes(quoter));
     return { include: narrowed };
 }
-export function adaptTransaction(context, transaction, hyperCoreAction) {
+export function adaptTransaction(context, transaction, hyperCoreAction, automaticSourceChainIds) {
+    if ('chain' in transaction && 'kind' in transaction.chain) {
+        throw new UnsupportedAccountCapabilityError('Non-EVM origin execution is not supported yet. Use a viem EVM chain as the managed source.', { vm: transaction.chain.kind });
+    }
     const destination = 'chain' in transaction
         ? getChainReference(transaction.chain.id)
         : 'kind' in transaction.targetChain
@@ -553,7 +721,7 @@ export function adaptTransaction(context, transaction, hyperCoreAction) {
     const destinationChainId = destination.kind === 'evm' ? destination.id : undefined;
     const sourceChains = 'chain' in transaction
         ? [getChainReference(transaction.chain.id)]
-        : transaction.sourceChains?.map((chain) => getChainReference(chain.id));
+        : (transaction.sourceChains?.map((chain) => getChainReference(chain.id)) ?? automaticSourceChainIds?.map(getChainReference));
     const evmSources = sourceChains?.flatMap((chain) => chain.kind === 'evm' ? [chain] : []);
     return {
         destination,
@@ -722,9 +890,12 @@ function adaptSessionSelection(transaction, chains) {
         ]));
     }
     const chainIds = new Set(chains.flatMap((chain) => chain.kind === 'evm' && chain.id !== undefined ? [chain.id] : []));
-    if ('chain' in transaction)
+    if ('chain' in transaction && !('kind' in transaction.chain)) {
         chainIds.add(transaction.chain.id);
-    if ('targetChain' in transaction && 'id' in transaction.targetChain) {
+    }
+    if ('targetChain' in transaction &&
+        transaction.targetChain &&
+        'id' in transaction.targetChain) {
         chainIds.add(transaction.targetChain.id);
     }
     return Object.fromEntries([...chainIds].map((chainId) => [
@@ -738,11 +909,18 @@ function adaptSessionSelection(transaction, chains) {
 function adaptSourceAssets(sourceAssets, chainIds) {
     if (!sourceAssets)
         return chainIds ? { chainIds } : undefined;
+    const eligible = chainIds ? new Set(chainIds) : undefined;
+    const assertEligible = (chainId) => {
+        if (eligible && !eligible.has(chainId)) {
+            throw new UnsupportedAccountCapabilityError(`Source assets reference chain ${chainId}, which is outside the eligible source scope.`, { chainId });
+        }
+    };
     if (Array.isArray(sourceAssets)) {
         if (sourceAssets.length > 0 && typeof sourceAssets[0] === 'object') {
             const chainTokens = {};
             const chainTokenAmounts = {};
             for (const item of sourceAssets) {
+                assertEligible(item.chain.id);
                 const token = normalizeTokenAddress(item.address, item.chain.id, false);
                 if (item.amount === undefined)
                     (chainTokens[item.chain.id] ??= []).push(token);
@@ -765,7 +943,8 @@ function adaptSourceAssets(sourceAssets, chainIds) {
     }
     // ChainTokenMap: validate every per-chain list too, so symbols can't slip
     // through this input the way they can't through tokenRequests / ExactInputConfig.
-    for (const tokens of Object.values(sourceAssets)) {
+    for (const [chainId, tokens] of Object.entries(sourceAssets)) {
+        assertEligible(Number(chainId));
         validateTokenAddresses(tokens);
     }
     return { chainTokens: sourceAssets };

package/dist/src/api/accounts.d.ts

@@ -8,5 +8,5 @@ export interface SdkComposition {
     readonly snapshot: LegacySdkConfigSnapshot<unknown>;
 }
 export declare function composeSdk(input: SdkConstructionInput): SdkComposition;
-export declare function attachAccount(sdk: SdkComposition, config: RhinestoneAccountConfig): RhinestoneAccount;
+export declare function attachAccount<const C extends RhinestoneAccountConfig>(sdk: SdkComposition, config: C): RhinestoneAccount<C>;
 //# sourceMappingURL=accounts.d.ts.map

package/dist/src/api/accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../api/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;IACnE,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAA;CACpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAOtE;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAanB"}
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../api/accounts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAA;AAWzB,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,WAAW,CAAA;AAElB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;IACnE,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAA;CACpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAOtE;AA+BD,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,uBAAuB,EACnE,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,CAAC,GACR,iBAAiB,CAAC,CAAC,CAAC,CAmFtB"}