feat: Synapse Devnet support

packages/synapse-sdk/src/payments/service.ts

@@ -40,6 +40,7 @@ export class PaymentsService {
   private readonly _paymentsAddress: string
   private readonly _usdfcAddress: string
   private readonly _disableNonceManager: boolean
+  private readonly _multicall3Address: string | null
   // Cached contract instances
   private _usdfcContract: ethers.Contract | null = null
   private _paymentsContract: ethers.Contract | null = null
@@ -60,13 +61,15 @@ export class PaymentsService {
     signer: ethers.Signer,
     paymentsAddress: string,
     usdfcAddress: string,
-    disableNonceManager: boolean
+    disableNonceManager: boolean,
+    multicall3Address: string | null = null
   ) {
     this._provider = provider
     this._signer = signer
     this._paymentsAddress = paymentsAddress
     this._usdfcAddress = usdfcAddress
     this._disableNonceManager = disableNonceManager
+    this._multicall3Address = multicall3Address
   }
 
   /**
@@ -108,7 +111,15 @@ export class PaymentsService {
     const chainId = CHAIN_IDS[networkType]
 
     // Setup Multicall3 for batched RPC calls
-    const multicall3Address = CONTRACT_ADDRESSES.MULTICALL3[networkType]
+    const multicall3Address =
+      this._multicall3Address ?? CONTRACT_ADDRESSES.MULTICALL3[networkType as keyof typeof CONTRACT_ADDRESSES.MULTICALL3]
+    if (!multicall3Address) {
+      throw createError(
+        'PaymentsService',
+        '_getPermitSignature',
+        `No Multicall3 address available for network: ${networkType}`
+      )
+    }
     const multicall = new ethers.Contract(multicall3Address, CONTRACT_ABIS.MULTICALL3, this._provider)
 
     // Create interfaces for encoding/decoding

packages/synapse-sdk/src/session/key.ts

@@ -53,17 +53,20 @@ export class SessionKey {
   private readonly _registry: ethers.Contract
   private readonly _signer: ethers.Signer
   private readonly _owner: ethers.Signer
+  private readonly _multicall3Address: string | null
 
   public constructor(
     provider: ethers.Provider,
     sessionKeyRegistryAddress: string,
     signer: ethers.Signer,
-    owner: ethers.Signer
+    owner: ethers.Signer,
+    multicall3Address: string | null = null
   ) {
     this._provider = provider
     this._registry = new ethers.Contract(sessionKeyRegistryAddress, CONTRACT_ABIS.SESSION_KEY_REGISTRY, owner)
     this._signer = signer
     this._owner = owner
+    this._multicall3Address = multicall3Address
   }
 
   getSigner(): ethers.Signer {
@@ -78,11 +81,13 @@ export class SessionKey {
   async fetchExpiries(permissions: string[] = PDP_PERMISSIONS): Promise<Record<string, bigint>> {
     const network = await getFilecoinNetworkType(this._provider)
 
-    const multicall = new ethers.Contract(
-      CONTRACT_ADDRESSES.MULTICALL3[network],
-      CONTRACT_ABIS.MULTICALL3,
-      this._provider
-    )
+    const multicall3Address =
+      this._multicall3Address ?? CONTRACT_ADDRESSES.MULTICALL3[network as keyof typeof CONTRACT_ADDRESSES.MULTICALL3]
+    if (!multicall3Address) {
+      throw new Error(`No Multicall3 address available for network: ${network}`)
+    }
+
+    const multicall = new ethers.Contract(multicall3Address, CONTRACT_ABIS.MULTICALL3, this._provider)
     const registryInterface = new ethers.Interface(CONTRACT_ABIS.SESSION_KEY_REGISTRY)
 
     const [ownerAddress, signerAddress, registryAddress] = await Promise.all([

packages/synapse-sdk/src/sp-registry/service.ts

@@ -38,14 +38,16 @@ import type {
 export class SPRegistryService {
   private readonly _provider: ethers.Provider
   private readonly _registryAddress: string
+  private readonly _multicall3Address: string | null
   private _registryContract: ethers.Contract | null = null
 
   /**
    * Constructor for SPRegistryService
    */
-  constructor(provider: ethers.Provider, registryAddress: string) {
+  constructor(provider: ethers.Provider, registryAddress: string, multicall3Address: string | null = null) {
     this._provider = provider
     this._registryAddress = registryAddress
+    this._multicall3Address = multicall3Address
   }
 
   /**
@@ -453,7 +455,11 @@ export class SPRegistryService {
    */
   private async _getProvidersWithMulticall(providerIds: number[]): Promise<ProviderInfo[]> {
     const network = await getFilecoinNetworkType(this._provider)
-    const multicall3Address = CONTRACT_ADDRESSES.MULTICALL3[network]
+    const multicall3Address =
+      this._multicall3Address ?? CONTRACT_ADDRESSES.MULTICALL3[network as keyof typeof CONTRACT_ADDRESSES.MULTICALL3]
+    if (!multicall3Address) {
+      throw new Error(`No Multicall3 address available for network: ${network}`)
+    }
     const multicall = new ethers.Contract(multicall3Address, CONTRACT_ABIS.MULTICALL3, this._provider)
     const iface = new ethers.Interface(CONTRACT_ABIS.SERVICE_PROVIDER_REGISTRY)
 

packages/synapse-sdk/src/synapse.ts

@@ -22,7 +22,13 @@ import type {
   SubgraphConfig,
   SynapseOptions,
 } from './types.ts'
-import { CHAIN_IDS, CONTRACT_ADDRESSES, getFilecoinNetworkType } from './utils/index.ts'
+import {
+  CHAIN_IDS,
+  CONTRACT_ADDRESSES,
+  GENESIS_TIMESTAMPS,
+  getFilecoinNetworkType,
+  queryGenesisTimestamp,
+} from './utils/index.ts'
 import { WarmStorageService } from './warm-storage/index.ts'
 
 export class Synapse {
@@ -36,6 +42,8 @@ export class Synapse {
   private readonly _pieceRetriever: PieceRetriever
   private readonly _storageManager: StorageManager
   private _session: SessionKey | null = null
+  private readonly _genesisTimestamp: number
+  private readonly _multicall3Address: string
 
   /**
    * Create a new Synapse instance with async initialization.
@@ -118,31 +126,59 @@ export class Synapse {
     }
 
     // Final network validation
-    if (network !== 'mainnet' && network !== 'calibration') {
-      throw new Error(`Invalid network: ${String(network)}. Only 'mainnet' and 'calibration' are supported.`)
+    if (network !== 'mainnet' && network !== 'calibration' && network !== 'devnet') {
+      throw new Error(`Invalid network: ${String(network)}. Only 'mainnet', 'calibration', and 'devnet' are supported.`)
+    }
+
+    const genesisTimestamp =
+      options.genesisTimestamp ??
+      (network === 'devnet' ? await queryGenesisTimestamp(provider) : GENESIS_TIMESTAMPS[network])
+
+    const resolvedMulticall3Address =
+      options.multicall3Address ?? CONTRACT_ADDRESSES.MULTICALL3[network as keyof typeof CONTRACT_ADDRESSES.MULTICALL3]
+    if (!resolvedMulticall3Address) {
+      throw new Error(
+        network === 'devnet'
+          ? 'multicall3Address is required when using devnet'
+          : `No Multicall3 address configured for network: ${network}`
+      )
     }
 
     // Create Warm Storage service with initialized addresses
-    const warmStorageAddress = options.warmStorageAddress ?? CONTRACT_ADDRESSES.WARM_STORAGE[network]
-    if (!warmStorageAddress) {
-      throw new Error(`No Warm Storage address configured for network: ${network}`)
+    const resolvedWarmStorageAddress =
+      options.warmStorageAddress ?? CONTRACT_ADDRESSES.WARM_STORAGE[network as keyof typeof CONTRACT_ADDRESSES.WARM_STORAGE]
+    if (!resolvedWarmStorageAddress) {
+      throw new Error(
+        network === 'devnet'
+          ? 'warmStorageAddress is required when using devnet'
+          : `No Warm Storage address configured for network: ${network}`
+      )
     }
-    const warmStorageService = await WarmStorageService.create(provider, warmStorageAddress)
+    const warmStorageService = await WarmStorageService.create(
+      provider,
+      resolvedWarmStorageAddress,
+      resolvedMulticall3Address,
+      options.warmStorageViewAddress ?? null
+    )
+
+    const withCDNEnabled = network !== 'devnet' && options.withCDN === true
+    const withIpniEnabled = network === 'devnet' ? false : options.withIpni
 
     // Create payments service with discovered addresses
     const paymentsAddress = warmStorageService.getPaymentsAddress()
-    const usdfcAddress = warmStorageService.getUSDFCTokenAddress()
+    const usdfcAddress = options.usdfcAddress ?? warmStorageService.getUSDFCTokenAddress()
     const payments = new PaymentsService(
       provider,
       signer,
       paymentsAddress,
       usdfcAddress,
-      options.disableNonceManager === true
+      options.disableNonceManager === true,
+      resolvedMulticall3Address
     )
 
     // Create SPRegistryService for use in retrievers
     const registryAddress = warmStorageService.getServiceProviderRegistryAddress()
-    const spRegistry = new SPRegistryService(provider, registryAddress)
+    const spRegistry = new SPRegistryService(provider, registryAddress, resolvedMulticall3Address)
 
     // Initialize piece retriever (use provided or create default)
     let pieceRetriever: PieceRetriever
@@ -154,7 +190,7 @@ export class Synapse {
 
       // Check for subgraph option
       let baseRetriever: PieceRetriever = chainRetriever
-      if (options.subgraphConfig != null || options.subgraphService != null) {
+      if (withIpniEnabled !== false && (options.subgraphConfig != null || options.subgraphService != null)) {
         const subgraphService =
           options.subgraphService != null
             ? options.subgraphService
@@ -175,12 +211,14 @@ export class Synapse {
       provider,
       network,
       payments,
-      options.withCDN === true,
-      warmStorageAddress,
+      withCDNEnabled,
+      resolvedWarmStorageAddress,
       warmStorageService,
       pieceRetriever,
       options.dev === false,
-      options.withIpni
+      withIpniEnabled,
+      genesisTimestamp,
+      resolvedMulticall3Address
     )
   }
 
@@ -190,12 +228,13 @@ export class Synapse {
     network: FilecoinNetworkType,
     payments: PaymentsService,
     withCDN: boolean,
-
     warmStorageAddress: string,
     warmStorageService: WarmStorageService,
     pieceRetriever: PieceRetriever,
     dev: boolean,
-    withIpni?: boolean
+    withIpni: boolean | undefined,
+    genesisTimestamp: number,
+    multicall3Address: string
   ) {
     this._signer = signer
     this._provider = provider
@@ -206,6 +245,8 @@ export class Synapse {
     this._pieceRetriever = pieceRetriever
     this._warmStorageAddress = warmStorageAddress
     this._session = null
+    this._genesisTimestamp = genesisTimestamp
+    this._multicall3Address = multicall3Address
 
     // Initialize StorageManager
     this._storageManager = new StorageManager(
@@ -273,7 +314,8 @@ export class Synapse {
       this._provider,
       this._warmStorageService.getSessionKeyRegistryAddress(),
       sessionKeySigner,
-      this._signer
+      this._signer,
+      this._multicall3Address
     )
   }
 
@@ -314,7 +356,27 @@ export class Synapse {
    * @returns The numeric chain ID
    */
   getChainId(): number {
-    return this._network === 'mainnet' ? CHAIN_IDS.mainnet : CHAIN_IDS.calibration
+    return this._network === 'mainnet'
+      ? CHAIN_IDS.mainnet
+      : this._network === 'calibration'
+        ? CHAIN_IDS.calibration
+        : CHAIN_IDS.devnet
+  }
+
+  /**
+   * Gets the genesis timestamp for the current network
+   * @returns Genesis timestamp in seconds (Unix timestamp)
+   */
+  getGenesisTimestamp(): number {
+    return this._genesisTimestamp
+  }
+
+  /**
+   * Gets the Multicall3 contract address in use
+   * @returns The Multicall3 address as a string
+   */
+  getMulticall3Address(): string {
+    return this._multicall3Address
   }
 
   /**
@@ -341,6 +403,46 @@ export class Synapse {
     return this._warmStorageService.getPDPVerifierAddress()
   }
 
+  /**
+   * Gets the USDFC token address for the current network
+   * @returns The USDFC token address
+   */
+  getUSDFCTokenAddress(): string {
+    return this._warmStorageService.getUSDFCTokenAddress()
+  }
+
+  /**
+   * Gets the Service Provider Registry address for the current network
+   * @returns The Service Provider Registry address
+   */
+  getServiceProviderRegistryAddress(): string {
+    return this._warmStorageService.getServiceProviderRegistryAddress()
+  }
+
+  /**
+   * Gets the Session Key Registry address for the current network
+   * @returns The Session Key Registry address
+   */
+  getSessionKeyRegistryAddress(): string {
+    return this._warmStorageService.getSessionKeyRegistryAddress()
+  }
+
+  /**
+   * Gets the Warm Storage View contract address for the current network
+   * @returns The Warm Storage View contract address
+   */
+  getWarmStorageViewAddress(): string {
+    return this._warmStorageService.getViewContractAddress()
+  }
+
+  /**
+   * Gets the FilBeam Beneficiary address for the current network
+   * @returns The FilBeam Beneficiary address
+   */
+  getFilBeamBeneficiaryAddress(): string {
+    return this._warmStorageService.getFilBeamBeneficiaryAddress()
+  }
+
   /**
    * Gets the payment service instance
    * @returns The payment service
@@ -436,7 +538,7 @@ export class Synapse {
 
       // Create SPRegistryService
       const registryAddress = this._warmStorageService.getServiceProviderRegistryAddress()
-      const spRegistry = new SPRegistryService(this._provider, registryAddress)
+      const spRegistry = new SPRegistryService(this._provider, registryAddress, this._multicall3Address)
 
       let providerInfo: ProviderInfo | null
       if (typeof providerAddress === 'string') {

packages/synapse-sdk/src/test/mocks/jsonrpc/index.ts

@@ -164,7 +164,10 @@ function handler(body: RpcRequest, options: JSONRPCOptions) {
         return warmStorageCallHandler(data as Hex, options)
       }
 
-      if (isAddressEqual(CONTRACT_ADDRESSES.MULTICALL3.calibration, to as Address)) {
+      if (
+        isAddressEqual(CONTRACT_ADDRESSES.MULTICALL3.calibration, to as Address) ||
+        isAddressEqual('0x1000000000000000000000000000000000000001' as Address, to as Address)
+      ) {
         return multicall3CallHandler(data as Hex, options)
       }