@blockrun/llm 3.12.0 → 3.13.1

package/dist/index.d.cts

@@ -2716,6 +2716,20 @@ declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferr
  * - Auto-creates wallet if none exists
  * - Stores key securely at ~/.blockrun/.session
  * - Generates EIP-681 URIs for easy MetaMask funding
+ *
+ * Key resolution, discovery, and adoption are delegated to `@blockrun/core`, the
+ * shared kernel every BlockRun product reads. That is what guarantees this SDK,
+ * the `blockrun` CLI, and clawrouter-codex all resolve the SAME wallet — the
+ * behaviour is defined in one place instead of being re-implemented per product
+ * and drifting. Kept SDK-local: the funding/messaging surface (SDK-specific),
+ * plus createWallet()/saveWallet() as thin persistence wrappers for API
+ * compatibility — they write to the same core-resolved path, per call.
+ *
+ * Because path resolution now comes from core, `BLOCKRUN_HOME` overrides the base
+ * directory (previously this module always used the OS home directory). Treat
+ * that variable as security-sensitive: it redirects where the signing key is
+ * read from AND written to, so an environment that can set it controls the
+ * wallet as surely as one that can set BLOCKRUN_WALLET_KEY.
  */
 declare const USDC_BASE_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 interface WalletInfo {
@@ -2748,12 +2762,15 @@ declare function saveWallet(privateKey: string): string;
 /**
  * Discover ~/.<dir>/wallet.json files from other providers.
  *
- * Each file should contain JSON with "privateKey" and "address" fields.
- * Results are sorted by modification time (most recent first). Discovery is
- * intentionally opt-in: a provider wallet must never replace the canonical
- * BlockRun wallet merely because it was written more recently.
+ * Each file should contain JSON with a "privateKey" field; the returned
+ * address is DERIVED from that key (any "address" field in the file is
+ * ignored, so a file cannot claim an address it holds no key for), and
+ * entries whose key does not parse are dropped. Results are sorted by
+ * modification time (most recent first). Discovery is intentionally opt-in:
+ * a provider wallet must never replace the canonical BlockRun wallet merely
+ * because it was written more recently.
  *
- * @returns Array of wallet objects with privateKey and address
+ * @returns Array of wallet objects with privateKey and derived address
  */
 declare function scanWallets(): Array<{
     privateKey: string;
@@ -2786,6 +2803,12 @@ declare function listDiscoveredWallets(): Array<{
  * The current `~/.blockrun/.session` is backed up beside itself before being
  * overwritten, so adopting a wallet can't strand the funds in the old one.
  *
+ * NOTE: this is NOT `@blockrun/core`'s `importWallet(rawPrivateKey)` — that
+ * one persists a raw key and refuses to overwrite without `force`. This SDK
+ * function adopts a DISCOVERED wallet by address and maps onto core's
+ * `adoptWallet()`. Same name, different operation; don't mix them up when
+ * importing from core directly.
+ *
  * @param address Address to adopt, as shown by `listDiscoveredWallets()`
  * @returns The adopted address
  * @throws If no discovered wallet derives to that address

package/dist/index.d.ts

@@ -2716,6 +2716,20 @@ declare function extractPaymentDetails(paymentRequired: PaymentRequired, preferr
  * - Auto-creates wallet if none exists
  * - Stores key securely at ~/.blockrun/.session
  * - Generates EIP-681 URIs for easy MetaMask funding
+ *
+ * Key resolution, discovery, and adoption are delegated to `@blockrun/core`, the
+ * shared kernel every BlockRun product reads. That is what guarantees this SDK,
+ * the `blockrun` CLI, and clawrouter-codex all resolve the SAME wallet — the
+ * behaviour is defined in one place instead of being re-implemented per product
+ * and drifting. Kept SDK-local: the funding/messaging surface (SDK-specific),
+ * plus createWallet()/saveWallet() as thin persistence wrappers for API
+ * compatibility — they write to the same core-resolved path, per call.
+ *
+ * Because path resolution now comes from core, `BLOCKRUN_HOME` overrides the base
+ * directory (previously this module always used the OS home directory). Treat
+ * that variable as security-sensitive: it redirects where the signing key is
+ * read from AND written to, so an environment that can set it controls the
+ * wallet as surely as one that can set BLOCKRUN_WALLET_KEY.
  */
 declare const USDC_BASE_CONTRACT = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 interface WalletInfo {
@@ -2748,12 +2762,15 @@ declare function saveWallet(privateKey: string): string;
 /**
  * Discover ~/.<dir>/wallet.json files from other providers.
  *
- * Each file should contain JSON with "privateKey" and "address" fields.
- * Results are sorted by modification time (most recent first). Discovery is
- * intentionally opt-in: a provider wallet must never replace the canonical
- * BlockRun wallet merely because it was written more recently.
+ * Each file should contain JSON with a "privateKey" field; the returned
+ * address is DERIVED from that key (any "address" field in the file is
+ * ignored, so a file cannot claim an address it holds no key for), and
+ * entries whose key does not parse are dropped. Results are sorted by
+ * modification time (most recent first). Discovery is intentionally opt-in:
+ * a provider wallet must never replace the canonical BlockRun wallet merely
+ * because it was written more recently.
  *
- * @returns Array of wallet objects with privateKey and address
+ * @returns Array of wallet objects with privateKey and derived address
  */
 declare function scanWallets(): Array<{
     privateKey: string;
@@ -2786,6 +2803,12 @@ declare function listDiscoveredWallets(): Array<{
  * The current `~/.blockrun/.session` is backed up beside itself before being
  * overwritten, so adopting a wallet can't strand the funds in the old one.
  *
+ * NOTE: this is NOT `@blockrun/core`'s `importWallet(rawPrivateKey)` — that
+ * one persists a raw key and refuses to overwrite without `force`. This SDK
+ * function adopts a DISCOVERED wallet by address and maps onto core's
+ * `adoptWallet()`. Same name, different operation; don't mix them up when
+ * importing from core directly.
+ *
  * @param address Address to adopt, as shown by `listDiscoveredWallets()`
  * @returns The adopted address
  * @throws If no discovered wallet derives to that address