@raac/rpc 2.0.0-beta.2 → 2.0.0-beta.20

package/dist/index.js

@@ -19,4 +19,5 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const RPCLibrary_1 = __importDefault(require("./RPCLibrary"));
 __exportStar(require("./utils/amount"), exports);
+__exportStar(require("./utils/rpcError"), exports);
 exports.default = RPCLibrary_1.default;

package/dist/methods/approveToken.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const getContractAddress_1 = require("../contracts/getContractAddress");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Approves `spender` to pull a token from the signer.
  * @param chainId The chain id.
@@ -22,14 +23,11 @@ const approveToken = async (chainId, tokenSymbol, spender, amount, signer) => {
     const tokenContract = new ethers_1.ethers.Contract(tokenAddress, tokenABI, signer);
     try {
         const tx = await tokenContract.approve(spender, amount);
-        console.log(`Approval transaction sent:`, tx.hash);
         const receipt = await tx.wait();
-        console.log(`Approved ${amount} ${tokenSymbol} for ${spender} successfully:`, receipt.transactionHash);
         return receipt;
     }
     catch (error) {
-        console.error(`Approval error:`, error);
-        throw new Error(`Token approval failed: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("methods.approveToken", error, { chainId, address: tokenAddress });
     }
 };
 exports.default = approveToken;

package/dist/methods/commons/checkAllowance.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkAllowance = void 0;
 const contracts_1 = require("../../utils/contracts");
 const amount_1 = require("../../utils/amount");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Reads how much of a token `spenderAddress` may pull from `address`.
  * @param chainId The chain id.
@@ -14,15 +15,13 @@ const amount_1 = require("../../utils/amount");
  */
 const checkAllowance = async (chainId, tokenId, address, spenderAddress, provider) => {
     let tokenAddress = (0, contracts_1.getContractAddress)(chainId, tokenId);
-    console.log(`[commons/checkAllowance] Checking allowance for ${address} to ${spenderAddress} on ${chainId} ${tokenId}:${tokenAddress}`);
     try {
         const tokenContract = (0, contracts_1.getContract)(chainId, tokenId, provider);
         const allowance = await tokenContract.allowance(address, spenderAddress);
         return (0, amount_1.toTokenAmount)(chainId, tokenId, allowance);
     }
     catch (error) {
-        console.error(`Error calling allowance: ${error}`);
-        throw new Error(`[commons/checkAllowance] ${chainId} ${tokenId}:${tokenAddress} ${address} ${spenderAddress} ${error}`);
+        throw (0, rpcError_1.toRpcError)("methods.checkAllowance", error, { chainId, address: tokenAddress });
     }
 };
 exports.checkAllowance = checkAllowance;

package/dist/methods/commons/estimateGasPrice.js

@@ -16,7 +16,6 @@ const estimateGasPrice = async (signer) => {
         };
     }
     catch (error) {
-        console.log("Error getting gas price", error);
         if (provider?.getGasPrice) {
             const gasPrice = await provider.getGasPrice();
             return { gasPrice };

package/dist/methods/getAssetBalance.js

@@ -4,6 +4,7 @@ exports.getAssetBalance = void 0;
 const ethers_1 = require("ethers");
 const getContractAddress_1 = require("../contracts/getContractAddress");
 const amount_1 = require("../utils/amount");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Reads a wallet's balance of a configured asset or native ETH.
  * @param chainId The chain id.
@@ -16,6 +17,7 @@ const getAssetBalance = async (chainId, address, assetId, signer) => {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    let tokenAddress;
     try {
         const provider = signer.provider;
         if (!provider) {
@@ -25,18 +27,16 @@ const getAssetBalance = async (chainId, address, assetId, signer) => {
             return (0, amount_1.toAmount)(await provider.getBalance(address), amount_1.WAD_DECIMALS, "ETH");
         }
         // @ts-ignore
-        const tokenAddress = (0, getContractAddress_1.getContractAddress)(chainId, assetId);
+        tokenAddress = (0, getContractAddress_1.getContractAddress)(chainId, assetId);
         const abi = ["function balanceOf(address) view returns (uint256)"];
         const contract = new ethers_1.ethers.Contract(tokenAddress, abi, provider);
         const balance = await contract.balanceOf(address);
         return (0, amount_1.toTokenAmount)(chainId, assetId, balance);
     }
     catch (error) {
-        console.error(`Error in getAssetBalance for ${assetId}:`, error);
         if (error.code === "BAD_DATA") {
-            console.error("Contract might not have balanceOf function. Check the contract address and ABI.");
         }
-        throw new Error(`Failed to fetch balance for ${assetId}: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("methods.getAssetBalance", error, { chainId, address: tokenAddress });
     }
 };
 exports.getAssetBalance = getAssetBalance;

package/dist/minter/emissionSchedule.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * TypeScript port of contracts/libraries/minters/EmissionSchedule.sol. The schedule is pure (no storage), so the
+ * whole curve can be drawn without one RPC call per week; the only on-chain input is the activation timestamp
+ * (`mintingStartAtTimestamp`). All amounts are RAAC base units (18 decimals).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAST_EMISSION_WEEK = exports.WEEKS_PER_PERIOD = exports.WEEK_REDUCTION_START = exports.BASE_PER_SECOND = exports.BASE_WEEKLY_EMISSION = void 0;
+exports.getEmissionPerSecondForWeek = getEmissionPerSecondForWeek;
+exports.getMintingWeekForTimestamp = getMintingWeekForTimestamp;
+exports.getEmissionSchedule = getEmissionSchedule;
+exports.getSchedulePosition = getSchedulePosition;
+const E18 = BigInt("1000000000000000000");
+const WEEK = BigInt(7 * 24 * 3600);
+/** RAAC emitted in each of the first 104 weeks. Divisible by 604800, so the per-second rate is exact. */
+exports.BASE_WEEKLY_EMISSION = BigInt("23852798580398015692800");
+exports.BASE_PER_SECOND = exports.BASE_WEEKLY_EMISSION / WEEK;
+/** First week of the reduction phase. */
+exports.WEEK_REDUCTION_START = 105;
+/** The rate drops by 5% every this many weeks. */
+exports.WEEKS_PER_PERIOD = 13;
+/** Weeks 781 and later emit nothing. */
+exports.LAST_EMISSION_WEEK = 780;
+/** 0.95^exponent with 1e18 precision, rounding exactly as the contract's `pow95`. */
+function pow95(exponent) {
+    let base = BigInt("950000000000000000");
+    let result = E18;
+    let e = exponent;
+    while (e !== BigInt(0)) {
+        if ((e & BigInt(1)) === BigInt(1))
+            result = (result * base) / E18;
+        base = (base * base) / E18;
+        e >>= BigInt(1);
+    }
+    return result;
+}
+/**
+ * RAAC emitted per second during a 1-based schedule week.
+ * @param week The schedule week; 0 and weeks after 780 emit nothing.
+ */
+function getEmissionPerSecondForWeek(week) {
+    if (week <= 0 || week > exports.LAST_EMISSION_WEEK)
+        return BigInt(0);
+    if (week < exports.WEEK_REDUCTION_START)
+        return exports.BASE_PER_SECOND;
+    const periods = BigInt(Math.floor((week - exports.WEEK_REDUCTION_START) / exports.WEEKS_PER_PERIOD) + 1);
+    return (exports.BASE_PER_SECOND * pow95(periods)) / E18;
+}
+/**
+ * The 1-based schedule week a timestamp falls in, 0 before activation.
+ * @param activationTimestamp `mintingStartAtTimestamp`, in UNIX seconds.
+ * @param timestamp The moment to place, in UNIX seconds.
+ */
+function getMintingWeekForTimestamp(activationTimestamp, timestamp) {
+    if (!activationTimestamp || timestamp < activationTimestamp)
+        return 0;
+    return Math.floor((timestamp - activationTimestamp) / Number(WEEK)) + 1;
+}
+let schedule = null;
+/** Every week of the schedule, 1 through 780, with running totals. The last `cumulative` is the lifetime emission. */
+function getEmissionSchedule() {
+    if (schedule)
+        return schedule;
+    let cumulative = BigInt(0);
+    schedule = Array.from({ length: exports.LAST_EMISSION_WEEK }, (_, i) => {
+        const week = i + 1;
+        const perSecond = getEmissionPerSecondForWeek(week);
+        const weekly = perSecond * WEEK;
+        cumulative += weekly;
+        return { week, perSecond, weekly, cumulative };
+    });
+    return schedule;
+}
+/**
+ * Places a moment on the schedule, e.g. to compare what has been minted with what the schedule allowed.
+ * @param activationTimestamp `mintingStartAtTimestamp`, in UNIX seconds.
+ * @param timestamp The moment to place, in UNIX seconds.
+ */
+function getSchedulePosition(activationTimestamp, timestamp) {
+    const week = getMintingWeekForTimestamp(activationTimestamp, timestamp);
+    if (week === 0)
+        return { week, secondsIntoWeek: 0, perSecond: BigInt(0), scheduledToDate: BigInt(0) };
+    const weeks = getEmissionSchedule();
+    if (week > exports.LAST_EMISSION_WEEK)
+        return { week, secondsIntoWeek: 0, perSecond: BigInt(0), scheduledToDate: weeks[exports.LAST_EMISSION_WEEK - 1].cumulative };
+    const secondsIntoWeek = (timestamp - activationTimestamp) % Number(WEEK);
+    const perSecond = getEmissionPerSecondForWeek(week);
+    const before = week > 1 ? weeks[week - 2].cumulative : BigInt(0);
+    return { week, secondsIntoWeek, perSecond, scheduledToDate: before + perSecond * BigInt(secondsIntoWeek) };
+}

package/dist/nfts/approveNFT.js

@@ -3,23 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function approveNFT(chainId, nftContractName, approvedAddress, tokenId, signer) {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
     try {
-        const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
         const nftABI = (0, artifacts_1.getABI)(nftContractName);
         const nftContract = new ethers_1.ethers.Contract(nftAddress, nftABI, signer);
-        console.log(`Approving NFT ${nftContractName} token ID ${tokenId} for ${approvedAddress}`);
         const tx = await nftContract.approve(approvedAddress, tokenId);
         const receipt = await tx.wait();
-        console.log(`Approved NFT ${nftContractName} token ID ${tokenId} for ${approvedAddress} successfully:`, receipt?.hash);
         return receipt;
     }
     catch (error) {
-        console.error(`Error approving NFT ${nftContractName}:`, error);
-        throw new Error(`Failed to approve NFT ${nftContractName}: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.approveNFT", error, { chainId, address: nftAddress });
     }
 }
 exports.default = approveNFT;

package/dist/nfts/getAllTokens.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function getAllTokens(chainId, provider, pagination) {
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const totalSupply = await raacNFTContract.totalSupply();
@@ -18,7 +19,6 @@ async function getAllTokens(chainId, provider, pagination) {
             const limit = pagination?.limit || 10;
             const start = offset;
             const end = Math.min(offset + limit, Number(totalSupply)) || totalSupply;
-            console.log(offset, limit, start, end);
             tokens = await raacNFTContract["getAllTokens(uint256,uint256)"](start, end);
         }
         else {
@@ -27,8 +27,7 @@ async function getAllTokens(chainId, provider, pagination) {
         return tokens;
     }
     catch (error) {
-        console.error("Error getting all tokens:", error);
-        throw new Error(`Failed to get all tokens: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getAllTokens", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getAllTokens;

package/dist/nfts/getApprovalForAll.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Check if an address is approved for all tokens of an NFT contract (operator approval)
  * @param chainId - The chain ID
@@ -16,17 +17,15 @@ async function getApprovedForAll(chainId, nftContractName, owner, operator, prov
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
     try {
-        const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
         const nftABI = (0, artifacts_1.getABI)(nftContractName);
         const nftContract = new ethers_1.ethers.Contract(nftAddress, nftABI, provider);
         const isApproved = await nftContract.isApprovedForAll(owner, operator);
-        console.log(`NFT ${nftContractName}: ${operator} is ${isApproved ? 'approved' : 'not approved'} for all tokens of ${owner}`);
         return isApproved;
     }
     catch (error) {
-        console.error(`Error checking NFT approval for all for ${nftContractName}:`, error);
-        throw new Error(`Failed to check NFT approval for all for ${nftContractName}: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getApprovedForAll", error, { chainId, address: nftAddress });
     }
 }
 exports.default = getApprovedForAll;

package/dist/nfts/getBaseUri.js

@@ -3,21 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function getBaseUri(chainId, provider) {
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const uri = await raacNFTContract.baseURI();
-        console.log(`Retrieved base uri: ${uri}`);
         return uri;
     }
     catch (error) {
-        console.error("Error adding new batch:", error);
-        throw new Error(`Failed to add new batch: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getBaseUri", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getBaseUri;

package/dist/nfts/getHousePrice.js

@@ -4,6 +4,7 @@ const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 const amount_1 = require("../utils/amount");
 /**
  * Reads the house price of a RAAC NFT, without the mint fee.
@@ -13,16 +14,15 @@ const amount_1 = require("../utils/amount");
  * @returns The price in the NFT's payment token, from the chain config (`nfts.raacnft.asset`).
  */
 async function getHousePrice(chainId, tokenId, provider) {
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const price = await raacNFTContract.getHousePrice(tokenId);
         return (0, amount_1.toTokenAmount)(chainId, (0, _helpers_1.getNftAssetId)(chainId), price);
     }
     catch (error) {
-        console.error("Error getting house price:", error);
-        throw new Error(`Failed to get house price: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getHousePrice", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getHousePrice;

package/dist/nfts/getMintFeePercentage.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Reads the RAAC NFT mint fee.
  * @param chainId The chain id.
@@ -13,15 +14,14 @@ async function getMintFeePercentage(chainId, provider) {
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         return await raacNFTContract.MINT_FEE_PERCENTAGE();
     }
     catch (error) {
-        console.log("Error retrieving mint fee percentage", error);
-        throw new Error(`Failed to retrieve mint fee percentage: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getMintFeePercentage", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getMintFeePercentage;

package/dist/nfts/getMintPrice.js

@@ -4,6 +4,7 @@ const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 const amount_1 = require("../utils/amount");
 /**
  * Reads the total price to mint a RAAC NFT: the house price plus the mint fee.
@@ -16,16 +17,15 @@ async function getMintPrice(chainId, tokenId, provider) {
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const price = await raacNFTContract.getMintPrice(tokenId);
         return (0, amount_1.toTokenAmount)(chainId, (0, _helpers_1.getNftAssetId)(chainId), price);
     }
     catch (error) {
-        console.error("Error retrieving mint price for " + tokenId, error);
-        throw new Error(`Failed retrieve mint price: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getMintPrice", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getMintPrice;

package/dist/nfts/getNFTApproval.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Check if an NFT token is approved for a specific address
  * @param chainId - The chain ID
@@ -16,18 +17,16 @@ async function getNFTApproval(chainId, nftContractName, tokenId, checkAddress, p
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
     try {
-        const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
         const nftABI = (0, artifacts_1.getABI)(nftContractName);
         const nftContract = new ethers_1.ethers.Contract(nftAddress, nftABI, provider);
         const approvedAddress = await nftContract.getApproved(tokenId);
         const isApproved = approvedAddress.toLowerCase() === checkAddress.toLowerCase();
-        console.log(`NFT ${nftContractName} token ID ${tokenId} is ${isApproved ? 'approved' : 'not approved'} for ${checkAddress}`);
         return isApproved;
     }
     catch (error) {
-        console.error(`Error checking NFT approval for ${nftContractName}:`, error);
-        throw new Error(`Failed to check NFT approval for ${nftContractName}: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getNFTApproval", error, { chainId, address: nftAddress });
     }
 }
 exports.default = getNFTApproval;

package/dist/nfts/getNFTBalance.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const contracts_1 = require("../utils/contracts");
+const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
+/**
+ * Get how many tokens of an NFT contract an address holds
+ * @param chainId - The chain ID
+ * @param nftContractName - The NFT contract name from configs
+ * @param owner - The address to check
+ * @param provider - The provider to use for the contract call
+ * @returns The number of tokens held
+ */
+async function getNFTBalance(chainId, nftContractName, owner, provider) {
+    if (!provider) {
+        throw new Error("Provider not available");
+    }
+    const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
+    try {
+        const nftABI = (0, artifacts_1.getABI)(nftContractName);
+        const nftContract = new ethers_1.ethers.Contract(nftAddress, nftABI, provider);
+        return await nftContract.balanceOf(owner);
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("nfts.getNFTBalance", error, { chainId, address: nftAddress });
+    }
+}
+exports.default = getNFTBalance;

package/dist/nfts/getOwnerOfNFT.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 /**
  * Get the owner of an NFT token
  * @param chainId - The chain ID
@@ -15,12 +16,11 @@ async function getOwnerOfNFT(chainId, nftContractName, tokenId, provider) {
     if (!provider) {
         throw new Error("Provider not available");
     }
+    const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
     try {
-        const nftAddress = (0, contracts_1.getContractAddress)(chainId, nftContractName);
         const nftABI = (0, artifacts_1.getABI)(nftContractName);
         const nftContract = new ethers_1.ethers.Contract(nftAddress, nftABI, provider);
         const owner = await nftContract.ownerOf(tokenId);
-        console.log(`NFT ${nftContractName} token ID ${tokenId} is owned by ${owner}`);
         return owner;
     }
     catch (error) {
@@ -29,11 +29,9 @@ async function getOwnerOfNFT(chainId, nftContractName, tokenId, provider) {
         if (error.message?.includes("nonexistent token") ||
             error.message?.includes("invalid token ID") ||
             error.message?.includes("ERC721: owner query for nonexistent token")) {
-            console.log(`NFT ${nftContractName} token ID ${tokenId} does not exist or has no owner`);
             return null;
         }
-        console.error(`Error getting owner of NFT ${nftContractName} token ID ${tokenId}:`, error);
-        throw new Error(`Failed to get owner of NFT ${nftContractName}: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getOwnerOfNFT", error, { chainId, address: nftAddress });
     }
 }
 exports.default = getOwnerOfNFT;

package/dist/nfts/getPriceStaleness.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHousePriceStale = isHousePriceStale;
+const ethers_1 = require("ethers");
+const contracts_1 = require("../utils/contracts");
+const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
+// RAACNFT storage: token at slot 13, TRADE_FEE_PERCENTAGE at 17, PRICE_STALENESS_THRESHOLD at 18, feeCollector at 19.
+const TOKEN_SLOT = 13;
+const TRADE_FEE_SLOT = 17;
+const THRESHOLD_SLOT = 18;
+const FEE_COLLECTOR_SLOT = 19;
+/**
+ * Reads RAACNFT's `PRICE_STALENESS_THRESHOLD`, the maximum age of a house price that `mint` accepts. The variable has
+ * no getter, so it is read from storage slot 18, trusted only when the neighbouring slots match `token()`,
+ * `TRADE_FEE_PERCENTAGE()` and `feeCollector()` (the layout is as expected).
+ * @param chainId The chain id.
+ * @param provider The provider to read with.
+ * @returns The threshold in seconds (0 turns the check off), or null when the storage layout could not be confirmed.
+ */
+async function getPriceStalenessThreshold(chainId, provider) {
+    const at = (0, contracts_1.getContractAddress)(chainId, "raacnft");
+    try {
+        const nft = new ethers_1.ethers.Contract(at, (0, artifacts_1.getABI)("raacnft"), provider);
+        const [token, tradeFee, feeCollector, ...slots] = await Promise.all([
+            nft.token(),
+            nft.TRADE_FEE_PERCENTAGE(),
+            nft.feeCollector(),
+            ...[TOKEN_SLOT, TRADE_FEE_SLOT, FEE_COLLECTOR_SLOT, THRESHOLD_SLOT].map((slot) => provider.getStorage(at, slot)),
+        ]);
+        const [tokenSlot, tradeFeeSlot, feeCollectorSlot, threshold] = slots.map((v) => BigInt(v));
+        const layoutOk = tokenSlot === BigInt(token) && tradeFeeSlot === tradeFee && feeCollectorSlot === BigInt(feeCollector);
+        return layoutOk ? Number(threshold) : null;
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("nfts.getPriceStalenessThreshold", error, { chainId, address: at });
+    }
+}
+/**
+ * Whether RAACNFT's `mint` would reject a house price as stale (`StalePriceData`), as `_validatePriceFreshness` decides:
+ * a price never set, or older than the threshold when the threshold is not 0. Only minting checks this; the lending
+ * pool's NFT adapter values collateral at the price whatever its age.
+ * @param priceTimestamp Unix seconds of the house price update; 0 when never priced.
+ * @param threshold `getPriceStalenessThreshold` in seconds.
+ * @param now Unix seconds to judge at, normally the latest block's timestamp.
+ * @returns True when a mint of this token would revert with `StalePriceData`.
+ */
+function isHousePriceStale(priceTimestamp, threshold, now) {
+    return priceTimestamp === 0 || (threshold > 0 && now > priceTimestamp + threshold);
+}
+exports.default = getPriceStalenessThreshold;

package/dist/nfts/getTokenURI.js

@@ -3,21 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function getTokenURI(chainId, tokenId, provider) {
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const uri = await raacNFTContract.tokenURI(tokenId);
-        console.log(`Retrieved token URI: ${uri}`);
         return uri;
     }
     catch (error) {
-        console.error("Error getting token URI:", error);
-        throw new Error(`Failed to get token URI: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getTokenURI", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getTokenURI;

package/dist/nfts/getTokensByOwner.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function getTokensByOwner(chainId, address, provider, pagination) {
+    const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
     try {
-        const raacNFTAddress = (0, contracts_1.getContractAddress)(chainId, "raacnft");
         const raacNFTABI = (0, artifacts_1.getABI)("raacnft");
         const raacNFTContract = new ethers_1.ethers.Contract(raacNFTAddress, raacNFTABI, provider);
         const balance = await raacNFTContract.balanceOf(address);
@@ -19,7 +20,6 @@ async function getTokensByOwner(chainId, address, provider, pagination) {
             const start = offset;
             const end = Math.min(offset + limit, Number(balance)) || balance;
             tokens = await raacNFTContract["getTokensByOwner(address,uint256,uint256)"](address, start, end);
-            console.log(offset, limit, start, end);
         }
         else {
             tokens = await raacNFTContract["getTokensByOwner(address)"](address);
@@ -28,8 +28,7 @@ async function getTokensByOwner(chainId, address, provider, pagination) {
         return { address, tokens: tokens.map((token) => token.toString()) };
     }
     catch (error) {
-        console.error("Error getting owned NFTs:", error);
-        throw new Error(`Failed to get owned NFTs: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getTokensByOwner", error, { chainId, address: raacNFTAddress });
     }
 }
 exports.default = getTokensByOwner;

package/dist/nfts/getTotalPropertiesCount.js

@@ -3,21 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
+const rpcError_1 = require("../utils/rpcError");
 async function getTotalPropertiesCount(chainId, provider) {
     if (!provider) {
         throw new Error("Wallet not connected");
     }
+    const raacHousePrices = (0, contracts_1.getContractAddress)(chainId, "raachouseprices");
     try {
-        const raacHousePrices = (0, contracts_1.getContractAddress)(chainId, "raachouseprices");
         const raacHousePricesABI = (0, artifacts_1.getABI)("raachouseprices");
         const raacHousePricesContract = new ethers_1.ethers.Contract(raacHousePrices, raacHousePricesABI, provider);
         const count = await raacHousePricesContract.count();
-        console.log(`Retrieved total properties count: ${count}`);
         return count;
     }
     catch (error) {
-        console.error("Error retrieving total houses count:", error);
-        throw new Error(`Failed to retrieve the number of houses: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("nfts.getTotalPropertiesCount", error, { chainId, address: raacHousePrices });
     }
 }
 exports.default = getTotalPropertiesCount;