@gvnrdao/dh-sdk 0.0.313 → 0.0.315

package/dist/index.js

@@ -1310,30 +1310,30 @@ var require_pkg_src = __commonJS({
         }
       },
       btcTransactionSigner: {
-        cid: "QmZFzjpdwpiBxHPv3t1mhjv8hfPRD1hPZGJ7jUU9w6V2Ca",
+        cid: "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic",
         authorizedCidHex: cidToHex(
-          "QmZFzjpdwpiBxHPv3t1mhjv8hfPRD1hPZGJ7jUU9w6V2Ca"
+          "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic"
         ),
         name: "Btc Transaction Signer",
         description: "Production Btc Transaction Signer",
         version: "1.1.1",
         deployed: true,
-        deployedAt: 1785173232972,
-        size: 66562,
-        hash: "13639ec13bfed381c3c9d81e17e37917446ba30d04d4d8e45809a6868139c3cb"
+        deployedAt: 1785226367707,
+        size: 66624,
+        hash: "9e0d9909519d5133bab03a9491566870b08d8b42c80e2d768bd24f02946cc781"
       },
       ucdMintValidator: {
-        cid: "Qmb1TPCaNYRTHsnhZrE1J4BtVYNWBnWSneXRqyAco1XKku",
+        cid: "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc",
         authorizedCidHex: cidToHex(
-          "Qmb1TPCaNYRTHsnhZrE1J4BtVYNWBnWSneXRqyAco1XKku"
+          "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc"
         ),
         name: "Ucd Mint Validator",
         description: "Production Ucd Mint Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173240530,
-        size: 81596,
-        hash: "fdaa7abb4ad28ae1f20f5cd6e3e03e5a8787fd6ac05938f51070ed16844f80f5",
+        deployedAt: 1785226381631,
+        size: 81658,
+        hash: "d8ea21622885c3d26fdb64e2ba9d2f9460753a5cd7934b2928858899537443eb",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x041ab17cd91fc5c0b761eea6092d032807561b621b82c488826776e04a9158d61ba64d809a4729f0501289d980732cb06d8dfd06999dd9c8efd2f495dad78b31bb",
@@ -1341,17 +1341,17 @@ var require_pkg_src = __commonJS({
         }
       },
       processPaymentValidator: {
-        cid: "QmWSSAgmLtfVsRawHU2Uf72Xw4hM5T5Jcx2n7EVmEHQD1E",
+        cid: "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX",
         authorizedCidHex: cidToHex(
-          "QmWSSAgmLtfVsRawHU2Uf72Xw4hM5T5Jcx2n7EVmEHQD1E"
+          "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX"
         ),
         name: "Process Payment Validator",
         description: "Production Process Payment Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173245463,
-        size: 77593,
-        hash: "0f1015e51702abd9834e295ea12ac8dbd906909d25f72ad6a509c061e625c75d",
+        deployedAt: 1785226385509,
+        size: 77655,
+        hash: "3c2af3c3e62e8e606d35f81fd7e6f4943f8516a9bef74f4150c8c1767cbd316f",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04cfccb9b6c7addc79469c0e9fafebef4c70801302c62cdb26b610723a9b8527d23f98a40158c7340d83fd0e62d02b5ec74c12f7a86d98e8c6973b4811110f19ad",
@@ -1359,17 +1359,17 @@ var require_pkg_src = __commonJS({
         }
       },
       extendPositionValidator: {
-        cid: "QmZyx9qUVyWu7deCJFLZxB1WDVRBgobs1Vm6m4ECGMbpkS",
+        cid: "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM",
         authorizedCidHex: cidToHex(
-          "QmZyx9qUVyWu7deCJFLZxB1WDVRBgobs1Vm6m4ECGMbpkS"
+          "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM"
         ),
         name: "Extend Position Validator",
         description: "Production Extend Position Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173255906,
-        size: 75372,
-        hash: "545dc96a7e9b4d0aaadf239127b804a92df60b6b5b2fbb3203ef7de9ad97980a",
+        deployedAt: 1785226398291,
+        size: 75434,
+        hash: "ba55532fbeaf6e65d180b869fd69ee06393d574daa0ace524a9e831d846539a5",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04e52338f6a0c3362800f1a94c4c8f08be5030dde0fa217388c53d1c1a4790f4443c9f2886b2d2d8f4b75a9a156e9b028011b1a1cf7648da0e556aa980ec692836",
@@ -1377,17 +1377,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcWithdrawal: {
-        cid: "QmXKsozVz832mvU5xgvFnAAms1kfQrHAKj1areHfkDkoK7",
+        cid: "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5",
         authorizedCidHex: cidToHex(
-          "QmXKsozVz832mvU5xgvFnAAms1kfQrHAKj1areHfkDkoK7"
+          "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5"
         ),
         name: "Btc Withdrawal",
         description: "Production Btc Withdrawal",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173260209,
-        size: 92692,
-        hash: "18ade8e4f0c79896eee613d16c86de135f1d3daaa0fa056bcdbcaa0dff793c77",
+        deployedAt: 1785226412397,
+        size: 92754,
+        hash: "d3a8ec62e0b1e6d0566a154a884bf7ee4e25ef6dc2dd84fde98211d25c1dede5",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x043616787c5432415c24378c4ef48de2bcd6bb7b575b837e3cff09171802662da7105d79586c7659677a0ecbaddac4cce06cb2a11f69a16fa0c4d7002ac7d51a4d",
@@ -1517,17 +1517,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcUtxoInvalidator: {
-        cid: "Qmc9W2dgGpRax5Q2nXw8ciGF9RHjWj1y9v2MMWNbrCwnZb",
+        cid: "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm",
         authorizedCidHex: cidToHex(
-          "Qmc9W2dgGpRax5Q2nXw8ciGF9RHjWj1y9v2MMWNbrCwnZb"
+          "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm"
         ),
         name: "Btc Utxo Invalidator",
         description: "Production Btc Utxo Invalidator",
         version: "1.0.0",
         deployed: true,
-        deployedAt: 1785173292828,
-        size: 61410,
-        hash: "9ca3817ea626b4ebca184e20cae827a8a982f48d6cd1497e81bb4469aa282627"
+        deployedAt: 1785226423791,
+        size: 61472,
+        hash: "75eca528d8ac30ae8f21caaae206ccab162a83a048d622868e60f645f0c475e2"
       }
     };
     function getDeploymentsForNetwork(network) {
@@ -9178,6 +9178,23 @@ function createPKPManager(config) {
 // src/modules/loan/loan-creator.module.ts
 var import_ethers11 = require("ethers");
 var import_dh_lit_actions = __toESM(require_pkg_src());
+
+// src/utils/contract-wallet.utils.ts
+var contractWalletCache = /* @__PURE__ */ new Map();
+async function isContractWallet(provider, address) {
+  const { chainId } = await provider.getNetwork();
+  const cacheKey = `${chainId}:${address.toLowerCase()}`;
+  const cached = contractWalletCache.get(cacheKey);
+  if (cached !== void 0)
+    return cached;
+  const code = await provider.getCode(address);
+  const isContract = code !== "0x";
+  contractWalletCache.set(cacheKey, isContract);
+  return isContract;
+}
+
+// src/modules/loan/loan-creator.module.ts
+var CONTRACT_WALLET_POLL_INTERVAL_MS = 4e3;
 var LoanCreator = class {
   config;
   transactionTimeoutMs;
@@ -9401,6 +9418,11 @@ var LoanCreator = class {
         validatorSignature: validatorSignature.substring(0, 20) + "..."
       });
     }
+    this.config.onPkpCreated?.({
+      tokenId: pkpData.tokenId,
+      ethAddress: pkpData.ethAddress,
+      publicKey: pkpData.publicKey
+    });
     const addressesResult = await this.deriveBitcoinAddresses(
       pkpData.publicKey
     );
@@ -9573,6 +9595,12 @@ var LoanCreator = class {
           error: encErr instanceof Error ? encErr.message : String(encErr)
         });
       }
+      const provider = this.config.contractManager.getProvider();
+      const senderIsContractWallet = await isContractWallet(
+        provider,
+        await signerResult.value.getAddress()
+      );
+      const searchFromBlock = senderIsContractWallet ? await provider.getBlockNumber() : 0;
       const tx = await positionManager.createPosition(
         pkpIdBytes32,
         validatorSignature,
@@ -9594,19 +9622,20 @@ var LoanCreator = class {
       }
       if (this.config.debug) {
         log.info("\u23F3 Waiting for transaction confirmation", {
-          hash: tx.hash
+          // For a contract wallet this is the wallet's own id, not an L1 hash — which is
+          // exactly why the confirmation below does not wait on it.
+          hash: tx.hash,
+          senderIsContractWallet,
+          searchFromBlock: senderIsContractWallet ? searchFromBlock : void 0
         });
       }
       const confirmations = await this.createPositionConfirmations();
-      const receipt = await Promise.race([
-        tx.wait(confirmations),
-        new Promise(
-          (_, reject) => setTimeout(
-            () => reject(new Error("Transaction confirmation timeout")),
-            this.transactionTimeoutMs
-          )
-        )
-      ]);
+      const receipt = senderIsContractWallet ? await this.awaitPositionCreatedByPkpId(
+        positionManager,
+        pkpIdBytes32,
+        searchFromBlock,
+        confirmations
+      ) : await this.awaitReceiptByHash(tx, confirmations);
       if (!receipt)
         throw new Error("Transaction was not mined (receipt is null)");
       if (this.config.debug && receipt.logs) {
@@ -9740,6 +9769,81 @@ var LoanCreator = class {
     }
     return 3;
   }
+  /**
+   * EOA path: the returned hash is the L1 hash, so `tx.wait` is exact.
+   *
+   * The timer is cleared on settle — an uncleared one keeps the process alive for the
+   * full timeout after a fast confirmation, which in Node holds the event loop open.
+   */
+  async awaitReceiptByHash(tx, confirmations) {
+    let timer;
+    try {
+      return await Promise.race([
+        tx.wait(confirmations),
+        new Promise((_, reject) => {
+          timer = setTimeout(
+            () => reject(new Error("Transaction confirmation timeout")),
+            this.transactionTimeoutMs
+          );
+        })
+      ]);
+    } finally {
+      if (timer)
+        clearTimeout(timer);
+    }
+  }
+  /**
+   * Contract-wallet path: find this position by its `PositionCreated` log.
+   *
+   * `pkpId` is minted fresh per attempt and is the event's second indexed argument, so a
+   * topic filter on it identifies exactly this position without reference to any transaction
+   * hash. The filter deliberately leaves topic0 unconstrained: two `PositionCreated` ABIs are
+   * in circulation (see `extractPositionId`) and matching on the freshly-minted pkpId alone,
+   * scoped to this contract and to blocks at or after the send, is already unambiguous.
+   *
+   * The same confirmation depth as the EOA path is applied to the log's block, for the reason
+   * given at the call site: `positionId` does not survive a reorg unchanged.
+   */
+  async awaitPositionCreatedByPkpId(positionManager, pkpIdBytes32, fromBlock, confirmations) {
+    const provider = this.config.contractManager.getProvider();
+    const contractAddress = await positionManager.getAddress();
+    const deadline = Date.now() + this.transactionTimeoutMs;
+    while (Date.now() < deadline) {
+      const logs = await provider.getLogs({
+        address: contractAddress,
+        topics: [null, null, pkpIdBytes32],
+        fromBlock,
+        toBlock: "latest"
+      });
+      if (logs.length > 1) {
+        throw new Error(
+          `Expected at most one PositionCreated log for pkpId ${pkpIdBytes32}, found ${logs.length}`
+        );
+      }
+      const positionLog = logs[0];
+      if (positionLog) {
+        const head = await provider.getBlockNumber();
+        const depth = head - positionLog.blockNumber + 1;
+        if (depth >= confirmations) {
+          const receipt = await provider.getTransactionReceipt(
+            positionLog.transactionHash
+          );
+          if (!receipt) {
+            throw new Error(
+              `PositionCreated log for pkpId ${pkpIdBytes32} has no receipt at ${positionLog.transactionHash} \u2014 the block was reorged out mid-confirmation.`
+            );
+          }
+          return receipt;
+        }
+      }
+      await new Promise(
+        (resolve) => setTimeout(resolve, CONTRACT_WALLET_POLL_INTERVAL_MS)
+      );
+    }
+    throw new Error(
+      `Timed out after ${this.transactionTimeoutMs}ms waiting for the PositionCreated log for pkpId ${pkpIdBytes32}. The wallet may not have executed the transaction yet; the position must be rediscovered by pkpId before it is used.`
+    );
+  }
   /**
    * Re-read the receipt after confirmations and re-derive `positionId`, so a reorg
    * cannot leave the caller holding an id that never survived to the canonical chain.
@@ -18772,7 +18876,8 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       litNetwork: config.litNetwork,
       loanCreationValidatorVersion: config.validators?.loanCreation ?? 1,
       ethRpcUrl: config.ethRpcUrl,
-      temperSignaturesTest: config.temperSignaturesTest
+      temperSignaturesTest: config.temperSignaturesTest,
+      onPkpCreated: config.onPkpCreated
     });
     if (!loanCreatorResult.success) {
       throw new Error(

package/dist/index.mjs

@@ -1316,30 +1316,30 @@ var require_pkg_src = __commonJS({
         }
       },
       btcTransactionSigner: {
-        cid: "QmZFzjpdwpiBxHPv3t1mhjv8hfPRD1hPZGJ7jUU9w6V2Ca",
+        cid: "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic",
         authorizedCidHex: cidToHex(
-          "QmZFzjpdwpiBxHPv3t1mhjv8hfPRD1hPZGJ7jUU9w6V2Ca"
+          "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic"
         ),
         name: "Btc Transaction Signer",
         description: "Production Btc Transaction Signer",
         version: "1.1.1",
         deployed: true,
-        deployedAt: 1785173232972,
-        size: 66562,
-        hash: "13639ec13bfed381c3c9d81e17e37917446ba30d04d4d8e45809a6868139c3cb"
+        deployedAt: 1785226367707,
+        size: 66624,
+        hash: "9e0d9909519d5133bab03a9491566870b08d8b42c80e2d768bd24f02946cc781"
       },
       ucdMintValidator: {
-        cid: "Qmb1TPCaNYRTHsnhZrE1J4BtVYNWBnWSneXRqyAco1XKku",
+        cid: "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc",
         authorizedCidHex: cidToHex(
-          "Qmb1TPCaNYRTHsnhZrE1J4BtVYNWBnWSneXRqyAco1XKku"
+          "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc"
         ),
         name: "Ucd Mint Validator",
         description: "Production Ucd Mint Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173240530,
-        size: 81596,
-        hash: "fdaa7abb4ad28ae1f20f5cd6e3e03e5a8787fd6ac05938f51070ed16844f80f5",
+        deployedAt: 1785226381631,
+        size: 81658,
+        hash: "d8ea21622885c3d26fdb64e2ba9d2f9460753a5cd7934b2928858899537443eb",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x041ab17cd91fc5c0b761eea6092d032807561b621b82c488826776e04a9158d61ba64d809a4729f0501289d980732cb06d8dfd06999dd9c8efd2f495dad78b31bb",
@@ -1347,17 +1347,17 @@ var require_pkg_src = __commonJS({
         }
       },
       processPaymentValidator: {
-        cid: "QmWSSAgmLtfVsRawHU2Uf72Xw4hM5T5Jcx2n7EVmEHQD1E",
+        cid: "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX",
         authorizedCidHex: cidToHex(
-          "QmWSSAgmLtfVsRawHU2Uf72Xw4hM5T5Jcx2n7EVmEHQD1E"
+          "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX"
         ),
         name: "Process Payment Validator",
         description: "Production Process Payment Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173245463,
-        size: 77593,
-        hash: "0f1015e51702abd9834e295ea12ac8dbd906909d25f72ad6a509c061e625c75d",
+        deployedAt: 1785226385509,
+        size: 77655,
+        hash: "3c2af3c3e62e8e606d35f81fd7e6f4943f8516a9bef74f4150c8c1767cbd316f",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04cfccb9b6c7addc79469c0e9fafebef4c70801302c62cdb26b610723a9b8527d23f98a40158c7340d83fd0e62d02b5ec74c12f7a86d98e8c6973b4811110f19ad",
@@ -1365,17 +1365,17 @@ var require_pkg_src = __commonJS({
         }
       },
       extendPositionValidator: {
-        cid: "QmZyx9qUVyWu7deCJFLZxB1WDVRBgobs1Vm6m4ECGMbpkS",
+        cid: "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM",
         authorizedCidHex: cidToHex(
-          "QmZyx9qUVyWu7deCJFLZxB1WDVRBgobs1Vm6m4ECGMbpkS"
+          "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM"
         ),
         name: "Extend Position Validator",
         description: "Production Extend Position Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173255906,
-        size: 75372,
-        hash: "545dc96a7e9b4d0aaadf239127b804a92df60b6b5b2fbb3203ef7de9ad97980a",
+        deployedAt: 1785226398291,
+        size: 75434,
+        hash: "ba55532fbeaf6e65d180b869fd69ee06393d574daa0ace524a9e831d846539a5",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04e52338f6a0c3362800f1a94c4c8f08be5030dde0fa217388c53d1c1a4790f4443c9f2886b2d2d8f4b75a9a156e9b028011b1a1cf7648da0e556aa980ec692836",
@@ -1383,17 +1383,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcWithdrawal: {
-        cid: "QmXKsozVz832mvU5xgvFnAAms1kfQrHAKj1areHfkDkoK7",
+        cid: "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5",
         authorizedCidHex: cidToHex(
-          "QmXKsozVz832mvU5xgvFnAAms1kfQrHAKj1areHfkDkoK7"
+          "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5"
         ),
         name: "Btc Withdrawal",
         description: "Production Btc Withdrawal",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785173260209,
-        size: 92692,
-        hash: "18ade8e4f0c79896eee613d16c86de135f1d3daaa0fa056bcdbcaa0dff793c77",
+        deployedAt: 1785226412397,
+        size: 92754,
+        hash: "d3a8ec62e0b1e6d0566a154a884bf7ee4e25ef6dc2dd84fde98211d25c1dede5",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x043616787c5432415c24378c4ef48de2bcd6bb7b575b837e3cff09171802662da7105d79586c7659677a0ecbaddac4cce06cb2a11f69a16fa0c4d7002ac7d51a4d",
@@ -1523,17 +1523,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcUtxoInvalidator: {
-        cid: "Qmc9W2dgGpRax5Q2nXw8ciGF9RHjWj1y9v2MMWNbrCwnZb",
+        cid: "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm",
         authorizedCidHex: cidToHex(
-          "Qmc9W2dgGpRax5Q2nXw8ciGF9RHjWj1y9v2MMWNbrCwnZb"
+          "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm"
         ),
         name: "Btc Utxo Invalidator",
         description: "Production Btc Utxo Invalidator",
         version: "1.0.0",
         deployed: true,
-        deployedAt: 1785173292828,
-        size: 61410,
-        hash: "9ca3817ea626b4ebca184e20cae827a8a982f48d6cd1497e81bb4469aa282627"
+        deployedAt: 1785226423791,
+        size: 61472,
+        hash: "75eca528d8ac30ae8f21caaae206ccab162a83a048d622868e60f645f0c475e2"
       }
     };
     function getDeploymentsForNetwork(network) {
@@ -9099,6 +9099,23 @@ function createPKPManager(config) {
 // src/modules/loan/loan-creator.module.ts
 import { Contract as Contract3, Interface as Interface2, zeroPadValue as zeroPadValue4, toBeHex, SigningKey } from "ethers";
 var import_dh_lit_actions = __toESM(require_pkg_src());
+
+// src/utils/contract-wallet.utils.ts
+var contractWalletCache = /* @__PURE__ */ new Map();
+async function isContractWallet(provider, address) {
+  const { chainId } = await provider.getNetwork();
+  const cacheKey = `${chainId}:${address.toLowerCase()}`;
+  const cached = contractWalletCache.get(cacheKey);
+  if (cached !== void 0)
+    return cached;
+  const code = await provider.getCode(address);
+  const isContract = code !== "0x";
+  contractWalletCache.set(cacheKey, isContract);
+  return isContract;
+}
+
+// src/modules/loan/loan-creator.module.ts
+var CONTRACT_WALLET_POLL_INTERVAL_MS = 4e3;
 var LoanCreator = class {
   config;
   transactionTimeoutMs;
@@ -9322,6 +9339,11 @@ var LoanCreator = class {
         validatorSignature: validatorSignature.substring(0, 20) + "..."
       });
     }
+    this.config.onPkpCreated?.({
+      tokenId: pkpData.tokenId,
+      ethAddress: pkpData.ethAddress,
+      publicKey: pkpData.publicKey
+    });
     const addressesResult = await this.deriveBitcoinAddresses(
       pkpData.publicKey
     );
@@ -9494,6 +9516,12 @@ var LoanCreator = class {
           error: encErr instanceof Error ? encErr.message : String(encErr)
         });
       }
+      const provider = this.config.contractManager.getProvider();
+      const senderIsContractWallet = await isContractWallet(
+        provider,
+        await signerResult.value.getAddress()
+      );
+      const searchFromBlock = senderIsContractWallet ? await provider.getBlockNumber() : 0;
       const tx = await positionManager.createPosition(
         pkpIdBytes32,
         validatorSignature,
@@ -9515,19 +9543,20 @@ var LoanCreator = class {
       }
       if (this.config.debug) {
         log.info("\u23F3 Waiting for transaction confirmation", {
-          hash: tx.hash
+          // For a contract wallet this is the wallet's own id, not an L1 hash — which is
+          // exactly why the confirmation below does not wait on it.
+          hash: tx.hash,
+          senderIsContractWallet,
+          searchFromBlock: senderIsContractWallet ? searchFromBlock : void 0
         });
       }
       const confirmations = await this.createPositionConfirmations();
-      const receipt = await Promise.race([
-        tx.wait(confirmations),
-        new Promise(
-          (_, reject) => setTimeout(
-            () => reject(new Error("Transaction confirmation timeout")),
-            this.transactionTimeoutMs
-          )
-        )
-      ]);
+      const receipt = senderIsContractWallet ? await this.awaitPositionCreatedByPkpId(
+        positionManager,
+        pkpIdBytes32,
+        searchFromBlock,
+        confirmations
+      ) : await this.awaitReceiptByHash(tx, confirmations);
       if (!receipt)
         throw new Error("Transaction was not mined (receipt is null)");
       if (this.config.debug && receipt.logs) {
@@ -9661,6 +9690,81 @@ var LoanCreator = class {
     }
     return 3;
   }
+  /**
+   * EOA path: the returned hash is the L1 hash, so `tx.wait` is exact.
+   *
+   * The timer is cleared on settle — an uncleared one keeps the process alive for the
+   * full timeout after a fast confirmation, which in Node holds the event loop open.
+   */
+  async awaitReceiptByHash(tx, confirmations) {
+    let timer;
+    try {
+      return await Promise.race([
+        tx.wait(confirmations),
+        new Promise((_, reject) => {
+          timer = setTimeout(
+            () => reject(new Error("Transaction confirmation timeout")),
+            this.transactionTimeoutMs
+          );
+        })
+      ]);
+    } finally {
+      if (timer)
+        clearTimeout(timer);
+    }
+  }
+  /**
+   * Contract-wallet path: find this position by its `PositionCreated` log.
+   *
+   * `pkpId` is minted fresh per attempt and is the event's second indexed argument, so a
+   * topic filter on it identifies exactly this position without reference to any transaction
+   * hash. The filter deliberately leaves topic0 unconstrained: two `PositionCreated` ABIs are
+   * in circulation (see `extractPositionId`) and matching on the freshly-minted pkpId alone,
+   * scoped to this contract and to blocks at or after the send, is already unambiguous.
+   *
+   * The same confirmation depth as the EOA path is applied to the log's block, for the reason
+   * given at the call site: `positionId` does not survive a reorg unchanged.
+   */
+  async awaitPositionCreatedByPkpId(positionManager, pkpIdBytes32, fromBlock, confirmations) {
+    const provider = this.config.contractManager.getProvider();
+    const contractAddress = await positionManager.getAddress();
+    const deadline = Date.now() + this.transactionTimeoutMs;
+    while (Date.now() < deadline) {
+      const logs = await provider.getLogs({
+        address: contractAddress,
+        topics: [null, null, pkpIdBytes32],
+        fromBlock,
+        toBlock: "latest"
+      });
+      if (logs.length > 1) {
+        throw new Error(
+          `Expected at most one PositionCreated log for pkpId ${pkpIdBytes32}, found ${logs.length}`
+        );
+      }
+      const positionLog = logs[0];
+      if (positionLog) {
+        const head = await provider.getBlockNumber();
+        const depth = head - positionLog.blockNumber + 1;
+        if (depth >= confirmations) {
+          const receipt = await provider.getTransactionReceipt(
+            positionLog.transactionHash
+          );
+          if (!receipt) {
+            throw new Error(
+              `PositionCreated log for pkpId ${pkpIdBytes32} has no receipt at ${positionLog.transactionHash} \u2014 the block was reorged out mid-confirmation.`
+            );
+          }
+          return receipt;
+        }
+      }
+      await new Promise(
+        (resolve) => setTimeout(resolve, CONTRACT_WALLET_POLL_INTERVAL_MS)
+      );
+    }
+    throw new Error(
+      `Timed out after ${this.transactionTimeoutMs}ms waiting for the PositionCreated log for pkpId ${pkpIdBytes32}. The wallet may not have executed the transaction yet; the position must be rediscovered by pkpId before it is used.`
+    );
+  }
   /**
    * Re-read the receipt after confirmations and re-derive `positionId`, so a reorg
    * cannot leave the caller holding an id that never survived to the canonical chain.
@@ -18701,7 +18805,8 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
       litNetwork: config.litNetwork,
       loanCreationValidatorVersion: config.validators?.loanCreation ?? 1,
       ethRpcUrl: config.ethRpcUrl,
-      temperSignaturesTest: config.temperSignaturesTest
+      temperSignaturesTest: config.temperSignaturesTest,
+      onPkpCreated: config.onPkpCreated
     });
     if (!loanCreatorResult.success) {
       throw new Error(

package/dist/interfaces/chunks/config.i.d.ts

@@ -102,6 +102,24 @@ interface BaseSDKConfig {
      * contract wallet can leave that request open for minutes.
      */
     onSessionSignatureResolved?: (ok: boolean) => void;
+    /**
+     * Fires during loan creation the moment the PKP has been minted and validated,
+     * before the `createPosition` transaction is submitted.
+     *
+     * The PKP is minted fresh per attempt, so `tokenId` is a unique, send-independent
+     * handle on the position that transaction is about to create — it is the only
+     * identifier a caller can hold *before* a hash exists. UIs use it to recognise
+     * their own position in an indexed feed without depending on the transaction
+     * hash, which a contract wallet does not return in a usable form.
+     *
+     * Note `tokenId` is a decimal string; the on-chain and subgraph `pkpId` is the
+     * same value as 32-byte hex. Normalise before comparing.
+     */
+    onPkpCreated?: (pkp: {
+        tokenId: string;
+        ethAddress: string;
+        publicKey: string;
+    }) => void;
     ethRpcUrl?: string;
     chainId?: number;
     networkOverride?: {

package/dist/modules/loan/loan-creator.module.d.ts

@@ -61,6 +61,15 @@ export interface LoanCreatorConfig {
     ethRpcUrl?: string;
     /** Security testing: Temper signatures to test contract validation */
     temperSignaturesTest?: boolean;
+    /**
+     * Fires once the PKP is minted and validated, before `createPosition` is submitted.
+     * See `SDKConfig.onPkpCreated` for why this exists and for the tokenId encoding caveat.
+     */
+    onPkpCreated?: (pkp: {
+        tokenId: string;
+        ethAddress: string;
+        publicKey: string;
+    }) => void;
 }
 /**
  * Loan creation audit trail
@@ -133,6 +142,26 @@ export declare class LoanCreator {
      * Override with `createPositionConfirmations` when a chain needs more.
      */
     private createPositionConfirmations;
+    /**
+     * EOA path: the returned hash is the L1 hash, so `tx.wait` is exact.
+     *
+     * The timer is cleared on settle — an uncleared one keeps the process alive for the
+     * full timeout after a fast confirmation, which in Node holds the event loop open.
+     */
+    private awaitReceiptByHash;
+    /**
+     * Contract-wallet path: find this position by its `PositionCreated` log.
+     *
+     * `pkpId` is minted fresh per attempt and is the event's second indexed argument, so a
+     * topic filter on it identifies exactly this position without reference to any transaction
+     * hash. The filter deliberately leaves topic0 unconstrained: two `PositionCreated` ABIs are
+     * in circulation (see `extractPositionId`) and matching on the freshly-minted pkpId alone,
+     * scoped to this contract and to blocks at or after the send, is already unambiguous.
+     *
+     * The same confirmation depth as the EOA path is applied to the log's block, for the reason
+     * given at the call site: `positionId` does not survive a reorg unchanged.
+     */
+    private awaitPositionCreatedByPkpId;
     /**
      * Re-read the receipt after confirmations and re-derive `positionId`, so a reorg
      * cannot leave the caller holding an id that never survived to the canonical chain.