@ar.io/sdk 3.24.0 → 4.0.0-alpha.2

package/lib/esm/common/faucet.js

@@ -1,14 +1,25 @@
 const DEFAULT_FAUCET_API_URL = 'https://faucet.ario.permaweb.services';
 /**
- * Creates a proxy object that implements the TokenFaucet interface. It wraps the ARIOReadable instance and adds methods for claiming tokens from the faucet API.
- * @param arioInstance - The ARIOReadable instance
- * @param faucetApiUrl - The URL of the faucet API
- * @returns A proxy object that implements the TokenFaucet interface
+ * Wrap an ARIO instance with a `.faucet` namespace bound to the HTTP faucet
+ * backend. The faucet itself talks to a hosted HTTP service that issues
+ * test-ARIO transfers — it is not tied to any specific on-chain backend.
+ *
+ * NOTE: the AR.IO faucet backend has not yet been ported to issue Solana-
+ * mint transfers. The SDK surface is kept stable so consumers can wire up
+ * the new backend without code changes once it ships. The `processId`
+ * parameter identifies the faucet on the server side (legacy AO process
+ * id today; will likely become a Solana mint pubkey).
  */
-export function createFaucet({ arioInstance, faucetApiUrl = DEFAULT_FAUCET_API_URL, }) {
+export function createFaucet({ arioInstance, faucetApiUrl = DEFAULT_FAUCET_API_URL, processId, }) {
+    // The backend has no implicit default for `processId`; fail at the API
+    // boundary so callers get immediate feedback instead of an opaque HTTP
+    // error on the first faucet call.
+    if (typeof processId !== 'string' || processId.trim() === '') {
+        throw new Error('createFaucet: `processId` is required and must be non-empty');
+    }
     const faucet = new ARIOTokenFaucet({
         faucetUrl: faucetApiUrl,
-        processId: arioInstance.process.processId,
+        processId,
     });
     const proxy = new Proxy(arioInstance, {
         get(target, prop) {

package/lib/esm/common/index.js

@@ -18,9 +18,5 @@ export * from './logger.js';
 export * from './loggers/winston.js';
 export * from './ant.js';
 export * from './ant-registry.js';
-export * from './ant-versions.js';
 export * from './faucet.js';
-export * from './marketplace.js';
-// ao
 export * from './io.js';
-export * from './contracts/ao-process.js';