Update archiver/relay/solana-relay/staking to @audius/sdk ^15.3.1

Brings the four remaining pedalboard plugins still on the old SDK onto
^15.3.1, matching the version anti-abuse-oracle already runs in prod.

Plugin bumps:
- archiver:     10.0.0 -> ^15.3.1
- relay:        10.0.0 -> ^15.3.1
- solana-relay: 15.1.0 -> ^15.3.1
- staking:      10.0.0 -> ^15.3.1

Source migrations the new SDK requires:

- archiver: bare sdk() now exposes only the *generated* TracksApi,
  which doesn't include getTrackDownloadUrl. Switch the archiver's
  SDK helper to createSdkWithServices so the extended TracksApi
  (with getTrackDownloadUrl) is wired up.

- relay: bump 10.0.0 -> ^15.3.1, migrate sdk() -> createSdkWithServices
  so audiusSdk.services.entityManager (decodeManageEntity /
  recoverSigner) keeps working; switch the AudiusSdk type alias to
  AudiusSdkWithServices; drop the 'staging' environment value (no
  longer accepted by the SDK) by routing stage to 'production'.
  services.entityManager is now typed as optional on
  AudiusSdkWithServices but is always populated in practice by the
  SDK's default services, so add ! assertions at the call sites to
  keep tsc happy. Update the sandbox script to use apiEndpoint for
  the staging discovery node, and switch users.updateProfile (gone
  in 15.3.1) to the equivalent users.updateUser({ id, userId,
  metadata }) shape.

- solana-relay, staking: package.json bump only; no source changes
  (the SDK types they use - FirstBuyQuoteResponse, RelayRequestBody -
  are still exported, and staking has no @audius/sdk imports in src).

Intentionally NOT included:
- trending-challenge-rewards: stays at 14.1.0. The bump to 15.3.1
  with createSdkWithServices was tried in 044f0e2 and explicitly
  reverted in 2d9f65d; the revert reason isn't documented but
  predates this PR, so honoring it.
- anti-abuse-oracle: already at ^15.3.1 on main (PR #34); the original
  PR #20 AAO changes targeted the pre-migration source that no
  longer exists.

Pre-existing main-branch issues not addressed by this PR:
- apps/relay/src/middleware/logging.ts(21,5) has a pino Logger<never>
  type incompatibility introduced by the node 24 upgrade / pino pin
  commits. Unrelated to the SDK and present without this change.
- viem / abitype .d.ts syntax errors under node_modules are flagged
  by relay's TS 5.0.4 - same as on main, not introduced here.

Test plan:
- [x] npm install resolves all four plugins to @audius/sdk 15.3.1
- [x] tsc --noEmit on archiver, solana-relay, staking source is clean
- [x] relay tsc errors are reduced from ~10 to 1 (the pre-existing
      pino issue); all 'services does not exist on UsersApi' errors
      that existed on main are gone
- [ ] Smoke test the relay against a stage discovery node to confirm
      decodeManageEntity / recoverSigner paths still work end-to-end

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dylanjeffers

apps/archiver/package.json

@@ -14,7 +14,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@audius/sdk": "10.0.0",
+    "@audius/sdk": "^15.3.1",
     "@pedalboard/basekit": "*",
     "@pedalboard/logger": "*",
     "@pedalboard/storage": "*",

apps/archiver/src/sdk.ts

@@ -1,4 +1,4 @@
-import { sdk } from '@audius/sdk'
+import { createSdkWithServices } from '@audius/sdk'
 import { readConfig, Environment } from './config'
 
 const environmentToSdkEnvironment: Record<
@@ -9,7 +9,7 @@ const environmentToSdkEnvironment: Record<
   prod: 'production'
 }
 
-let audiusSdk: ReturnType<typeof sdk> | undefined = undefined
+let audiusSdk: ReturnType<typeof createSdkWithServices> | undefined = undefined
 
 export const getAudiusSdk = () => {
   if (audiusSdk === undefined) {
@@ -19,7 +19,9 @@ export const getAudiusSdk = () => {
     // inspectTrack land in the configured app's rps/rpm bucket on the server's
     // rate-limit middleware. The raw downloadFile fetch (which bypasses the
     // SDK entirely) attaches api_key itself — see downloadFile in utils.ts.
-    audiusSdk = sdk({
+    // Use createSdkWithServices (not sdk()) so tracks.getTrackDownloadUrl is
+    // available — the bare sdk() factory exposes only the generated TracksApi.
+    audiusSdk = createSdkWithServices({
       appName: 'audius-archiver',
       environment: environmentToSdkEnvironment[config.environment],
       apiKey: config.apiKey

apps/relay/package.json

@@ -17,7 +17,7 @@
     "preset": "jest-presets/jest/node"
   },
   "dependencies": {
-    "@audius/sdk": "10.0.0",
+    "@audius/sdk": "^15.3.1",
     "@bufbuild/protobuf": "2.2.3",
     "@connectrpc/connect": "2.0.1",
     "@connectrpc/connect-node": "2.0.1",

apps/relay/src/coreRelay.ts

@@ -114,7 +114,7 @@ export const coreRelay = async (
       metadata,
       subjectSig,
       nonce: nonceBytes
-    } = audiusSdk.services.entityManager.decodeManageEntity(
+    } = audiusSdk.services.entityManager!.decodeManageEntity(
       encodedABI as `0x${string}`
     )
 

apps/relay/src/index.ts

@@ -6,14 +6,14 @@ import { logger } from './logger'
 import { initializeDiscoveryDb } from '@pedalboard/basekit'
 import { connectWeb3 } from './web3'
 import { app } from './server'
-import { AudiusSdk, sdk } from '@audius/sdk'
+import { AudiusSdkWithServices, createSdkWithServices } from '@audius/sdk'
 
 export type SharedData = {
   config: Config
   web3: ethers.providers.JsonRpcProvider
-  sdk: AudiusSdk
+  sdk: AudiusSdkWithServices
   wallets: WalletManager
-  audiusSdk: AudiusSdk
+  audiusSdk: AudiusSdkWithServices
 }
 
 export const config = readConfig()
@@ -28,17 +28,13 @@ export const discoveryDb = initializeDiscoveryDb(
 
 export let web3: providers.JsonRpcProvider
 export let wallets: WalletManager
-export let audiusSdk: AudiusSdk
+export let audiusSdk: AudiusSdkWithServices
 
 const main = async () => {
-  audiusSdk = sdk({
+  audiusSdk = createSdkWithServices({
     appName: 'relay',
     environment:
-      config.environment === 'dev'
-        ? 'development'
-        : config.environment === 'stage'
-          ? 'staging'
-          : 'production'
+      config.environment === 'dev' ? 'development' : 'production'
   })
   try {
     // async config

apps/relay/src/middleware/rateLimiter.ts

@@ -92,7 +92,7 @@ export const rateLimiterMiddleware = async (
 }
 
 export const getEntityManagerActionKey = (encodedABI: string): string => {
-  const decodedABI = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedABI = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   const { action, entityType } = decodedABI

apps/relay/src/middleware/validator.ts

@@ -195,7 +195,7 @@ export const retrieveUser = async (
   // if entitymanager transaction, recover signer
   if (contractRegistryKey === 'EntityManager') {
     const recoveredAddress =
-      await audiusSdk.services.entityManager.recoverSigner(
+      await audiusSdk.services.entityManager!.recoverSigner(
         encodedABI as `0x${string}`
       )
 
@@ -232,7 +232,7 @@ export const retrieveDeveloperApp = async (params: {
   contractAddress: string
 }): Promise<DeveloperApps | undefined> => {
   const { encodedABI } = params
-  const recoveredAddress = await audiusSdk.services.entityManager.recoverSigner(
+  const recoveredAddress = await audiusSdk.services.entityManager!.recoverSigner(
     encodedABI as `0x${string}`
   )
   return await discoveryDb<DeveloperApps>(Table.DeveloperApps)

apps/relay/src/scripts/sandbox.ts

@@ -19,15 +19,17 @@ export const main = async () => {
 
   const audiusSdk = sdk({
     appName: 'experimentalDiscoveryRelay',
-    apiKey,
-    apiSecret,
-    environment: 'staging'
+    apiKey: apiKey!,
+    apiSecret: apiSecret!,
+    environment: 'production',
+    apiEndpoint: 'https://discoveryprovider.staging.audius.co'
   })
   const { data } = await audiusSdk.users.getUserByHandle({
     handle: 'totallynotalec'
   })
   const userId = data?.id!
-  const res = await audiusSdk.users.updateProfile({
+  const res = await audiusSdk.users.updateUser({
+    id: userId,
     userId,
     metadata: {
       bio: `identity has no reigns on me ${new Date().getTime()}`

apps/relay/src/utils.ts

@@ -1,7 +1,7 @@
 import { audiusSdk } from '.'
 
 export const isUserCreate = (encodedABI: string): boolean => {
-  const decodedAbi = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedAbi = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   return decodedAbi.action === 'Create' && decodedAbi.entityType === 'User'
@@ -11,7 +11,7 @@ export const isUserDeactivate = (
   isDeactivated: boolean,
   encodedABI: string
 ): boolean => {
-  const decodedAbi = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedAbi = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   return (
@@ -23,14 +23,14 @@ export const isUserDeactivate = (
 }
 
 export const isTrackDownload = (encodedABI: string) => {
-  const decodedAbi = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedAbi = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   return decodedAbi.action === 'Download' && decodedAbi.entityType === 'Track'
 }
 
 export const isViewNotification = (encodedABI: string): boolean => {
-  const decodedAbi = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedAbi = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   return (
@@ -39,7 +39,7 @@ export const isViewNotification = (encodedABI: string): boolean => {
 }
 
 export const isViewPlaylistNotification = (encodedABI: string): boolean => {
-  const decodedAbi = audiusSdk.services.entityManager.decodeManageEntity(
+  const decodedAbi = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   return (

apps/relay/src/validate.ts

@@ -2,7 +2,7 @@ import { audiusSdk } from '.'
 
 /// async in case we need to make a db call
 export const validateTransactionData = async (encodedABI: string) => {
-  const decoded = audiusSdk.services.entityManager.decodeManageEntity(
+  const decoded = audiusSdk.services.entityManager!.decodeManageEntity(
     encodedABI as `0x${string}`
   )
   // TODO: validate decoded tx with zod