feat(svm-sdk): svm sdk alt vm signer and provider implementation (#8280)

Author: xeno097

typescript/svm-sdk/src/clients/protocol.ts

@@ -1,7 +1,93 @@
-import type { Address, Instruction } from '@solana/kit';
+import type {
+  AltVM,
+  ChainMetadataForAltVM,
+  ITransactionSubmitter,
+  MinimumRequiredGasByAction,
+  ProtocolProvider,
+  SignerConfig,
+  TransactionSubmitterConfig,
+} from '@hyperlane-xyz/provider-sdk';
+import type { IProvider } from '@hyperlane-xyz/provider-sdk/altvm';
+import type { IRawHookArtifactManager } from '@hyperlane-xyz/provider-sdk/hook';
+import type { IRawIsmArtifactManager } from '@hyperlane-xyz/provider-sdk/ism';
+import type {
+  AnnotatedTx,
+  TxReceipt,
+} from '@hyperlane-xyz/provider-sdk/module';
+import type { IRawWarpArtifactManager } from '@hyperlane-xyz/provider-sdk/warp';
+import { address as parseAddress } from '@solana/kit';
+import { assert } from '@hyperlane-xyz/utils';
 
-export interface SvmInstructionEnvelope {
-  programAddress: Address;
-  instruction: Instruction;
-  label?: string;
+import { SvmHookArtifactManager } from '../hook/hook-artifact-manager.js';
+import { SvmIsmArtifactManager } from '../ism/ism-artifact-manager.js';
+import { createRpc } from '../rpc.js';
+
+import { SvmProvider } from './provider.js';
+import { SvmSigner } from './signer.js';
+
+export class SvmProtocolProvider implements ProtocolProvider {
+  createProvider(chainMetadata: ChainMetadataForAltVM): Promise<IProvider> {
+    const rpcUrls = this.getRpcUrls(chainMetadata);
+    return SvmProvider.connect(rpcUrls, chainMetadata.chainId);
+  }
+
+  async createSigner(
+    chainMetadata: ChainMetadataForAltVM,
+    config: SignerConfig,
+  ): Promise<AltVM.ISigner<AnnotatedTx, TxReceipt>> {
+    const rpcUrls = this.getRpcUrls(chainMetadata);
+    return SvmSigner.connectWithSigner(rpcUrls, config.privateKey);
+  }
+
+  createSubmitter<TConfig extends TransactionSubmitterConfig>(
+    _chainMetadata: ChainMetadataForAltVM,
+    _config: TConfig,
+  ): Promise<ITransactionSubmitter> {
+    throw new Error('Transaction submitter not yet implemented for Sealevel');
+  }
+
+  createIsmArtifactManager(
+    chainMetadata: ChainMetadataForAltVM,
+  ): IRawIsmArtifactManager {
+    const rpc = createRpc(this.getRpcUrls(chainMetadata)[0]);
+    return new SvmIsmArtifactManager(rpc);
+  }
+
+  createHookArtifactManager(
+    chainMetadata: ChainMetadataForAltVM,
+    context?: { mailbox?: string },
+  ): IRawHookArtifactManager {
+    assert(
+      context?.mailbox,
+      'Mailbox address is required for SVM hook artifact manager',
+    );
+    const rpc = createRpc(this.getRpcUrls(chainMetadata)[0]);
+    return new SvmHookArtifactManager(rpc, parseAddress(context.mailbox));
+  }
+
+  createWarpArtifactManager(
+    _chainMetadata: ChainMetadataForAltVM,
+    _context?: { mailbox?: string },
+  ): IRawWarpArtifactManager {
+    throw new Error('Warp artifact manager not yet implemented for Sealevel');
+  }
+
+  getMinGas(): MinimumRequiredGasByAction {
+    return {
+      CORE_DEPLOY_GAS: 0n,
+      // ~2.6 SOL covers program account rent + token PDA rent + ATA payer funding
+      WARP_DEPLOY_GAS: 2_600_000_000n,
+      TEST_SEND_GAS: 0n,
+      AVS_GAS: 0n,
+      ISM_DEPLOY_GAS: 0n,
+    };
+  }
+
+  private getRpcUrls(chainMetadata: ChainMetadataForAltVM): string[] {
+    assert(
+      chainMetadata.rpcUrls && chainMetadata.rpcUrls.length > 0,
+      'At least one RPC URL is required',
+    );
+    return chainMetadata.rpcUrls.map((r) => r.http);
+  }
 }