storacha-sol 0.0.4 → 0.0.6

package/README.md

@@ -11,12 +11,12 @@ Here are a couple of things you can do with this package:
 - View your upload history (all files you've stored with their details)
 - Get expiration warnings via email before your files expire
 - Automatic deletion of expired files from Storacha
+- Renew/extend storage duration for existing uploads
 
 Stuffs we hope to cover or extend:
 
 - Allow payments from other chains. (Filecoin next)
 - Include implementations for other libs. Right now, we only have React. Hoping to cover, Vue, Svelte etc.
-- Add ability to renew/increase upload duration (coming soon! see [GitHub issues](https://github.com/seetadev/storacha-solana-sdk/issues))
 
 ## Usage
 
@@ -123,6 +123,7 @@ console.log(history.userHistory); // Array of all deposits
 ```
 
 Each deposit in the history includes:
+
 - File details (name, size, type, CID)
 - Expiration date
 - Deletion status (`active`, `warned`, `deleted`)
@@ -149,6 +150,7 @@ const result = await client.createDeposit({
 If provided, you'll receive an email notification **7 days before your file expires**, giving you time to extend the storage duration (feature coming soon!).
 
 The warning email includes:
+
 - File name and CID
 - Exact expiration date
 - Number of days remaining
@@ -157,12 +159,74 @@ The warning email includes:
 ### Automatic Cleanup
 
 Files that have expired are automatically deleted from Storacha storage. This happens through a scheduled job that:
+
 1. Identifies expired deposits
 2. Removes the data from Storacha (including shards)
 3. Updates the deletion status in the database
 
 Your upload history will show the deletion status, so you can track which files are still active, warned, or deleted.
 
+### Storage Renewal
+
+Extend the storage duration for your existing uploads before they expire:
+
+```ts
+const client = useDeposit('testnet' as Environment);
+const { publicKey, signTransaction } = useSolanaWallet();
+
+// First, get a quote to see what it'll cost
+const quote = await client.getStorageRenewalCost(cid, 30); // 30 additional days
+
+console.log(`Current expiration: ${quote.currentExpirationDate}`);
+console.log(`New expiration: ${quote.newExpirationDate}`);
+console.log(`Cost: ${quote.costInSOL} SOL`);
+
+const result = await client.renewStorageDuration({
+  cid,
+  additionalDays: 30,
+  payer: publicKey,
+  signTransaction: async (tx) => {
+    const signed = await signTransaction(tx);
+    return signed;
+  },
+});
+
+if (result.success) {
+  console.log('Storage renewed! Transaction:', result.signature);
+}
+```
+
+**How it works:**
+
+- `getStorageRenewalCost()` shows you the cost and new expiration date before committing
+- `renewStorageDuration()` creates a payment transaction (same flow as initial upload)
+- After payment confirms, your file's expiration date gets updated
+
+## Usage with Vite
+
+When using this SDK in a project built with Vite, you may encounter a `ReferenceError: process is not defined`. This is because Vite does not automatically polyfill the Node.js `process` global, which this library may use.
+
+To resolve this, you can define `process.env` to safely access `NODE_ENV` and additionally install `vite-plugin-node-polyfills` as a dev dependency and edit your `vite.config.ts` file:
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { nodePolyfills } from 'vite-plugin-node-polyfills';
+
+export default defineConfig({
+  plugins: [react(), nodePolyfills()],
+  // ... other config
+  define: {
+    'process.env': {
+      NODE_ENV: JSON.stringify(process.env.NODE_ENV || 'production'),
+    },
+  },
+});
+```
+
+This will prevent the runtime error and allow the SDK to function correctly.
+
 ## Want to contribute?
 
 Read the [Contributing guide](CONTRIBUTING.md)

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var I=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var A=(r,e)=>{for(var n in e)I(r,n,{get:e[n],enumerable:!0})},B=(r,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of N(e))!$.call(r,s)&&s!==n&&I(r,s,{get:()=>e[s],enumerable:!(t=j(e,s))||t.enumerable});return r};var F=r=>B(I({},"__esModule",{value:!0}),r);var z={};A(z,{Client:()=>f,Environment:()=>x,createDepositTxn:()=>U,fetchUserDepositHistory:()=>P,getRpcUrl:()=>O,useDeposit:()=>H});module.exports=F(z);var T=require("@solana/web3.js");var{NODE_ENV:_}=process.env,l=_==="development"?"http://localhost:5040":"https://storacha-solana-sdk-bshc.onrender.com",v=86400;async function P(r,e={}){if(!r||typeof r!="string")throw new Error("User address is required and must be a string");let n=e.url||l;try{let t=await fetch(`${n}/api/user/user-upload-history?userAddress=${encodeURIComponent(r)}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!t.ok){let a=await t.json().catch(()=>({}));throw new Error(a.message||`Failed to fetch deposit history: ${t.status} ${t.statusText}`)}let s=await t.json();if(typeof s!="object"||s===null)throw new Error("Invalid response format from server");if(typeof s.userAddress!="string")throw new Error("Invalid userAddress in response");return s}catch(t){throw t instanceof Error?t:new Error("Unknown error occurred while fetching deposit history")}}var d=require("@solana/web3.js");async function U({file:r,duration:e,payer:n,connection:t,signTransaction:s,userEmail:a}){try{let o=new FormData;r.forEach(i=>o.append("file",i)),o.append("duration",e.toString()),o.append("publicKey",n.toBase58()),a&&o.append("userEmail",a);let h=r.length>1,w,S=await fetch(`${l}/api/solana/deposit`,{method:"POST",body:o});if(!S.ok)throw new Error("Failed to get deposit instructions");let c=await S.json();if(!c.instructions||!c.instructions.length)throw new Error("No instructions from deposit API");let g=await t.getLatestBlockhash("confirmed"),y=c.instructions[0],R=new d.TransactionInstruction({programId:new d.PublicKey(y.programId),keys:y.keys.map(i=>({pubkey:new d.PublicKey(i.pubkey),isSigner:i.isSigner,isWritable:i.isWritable})),data:Buffer.from(y.data,"base64")}),u=new d.Transaction;u.recentBlockhash=g.blockhash,u.feePayer=n,u.add(R);let C=await s(u),D=await t.sendRawTransaction(C.serialize(),{skipPreflight:!1,preflightCommitment:"confirmed"}),b=await t.confirmTransaction({signature:D,blockhash:g.blockhash,lastValidBlockHeight:g.lastValidBlockHeight},"confirmed");if(b.value.err)throw console.error("Failed to confirm this transaction:",b.value.err),new Error(`Transaction failed: ${JSON.stringify(b.value.err)}`);try{await fetch(`${l}/api/user/update-transaction-hash`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:c.cid,transactionHash:D})})}catch(i){console.warn("Failed to update transaction hash:",i)}c.error&&(w=c.error);let E=new FormData;r.forEach(i=>E.append("file",i));let m;if(h?m=await fetch(`${l}/api/user/upload-files?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:E}):m=await fetch(`${l}/api/user/upload-file?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:E}),!m.ok){let i="Unknown error";try{let k=await m.json();i=k.message||k.error||i}catch{}throw new Error("Deposit API error: "+i)}let p=await m?.json();return{signature:D,success:!0,cid:c.cid,url:p.object.url,message:p.object.message,fileInfo:p.object?{filename:p.object.fileInfo?.filename||"",size:p?.object?.fileInfo?.size||0,uploadedAt:p?.object?.fileInfo?.uploadedAt||"",type:p?.object?.fileInfo?.type||""}:void 0}}catch(o){return console.error(o),o instanceof Error&&(console.error("Error name:",o.name),console.error("Error message:",o.message),console.error("Error stack:",o.stack)),{signature:"",success:!1,cid:"",url:"",message:"",fileInfo:void 0,error:o instanceof Error?o.message:"Unknown error occurred"}}}var x=(t=>(t.mainnet="mainnet-beta",t.testnet="testnet",t.devnet="devnet",t))(x||{});function O(r){switch(r){case"mainnet-beta":return"https://api.mainnet-beta.solana.com";case"testnet":return"https://api.testnet.solana.com";case"devnet":return"https://api.devnet.solana.com";default:throw new Error(`Unsupported environment: ${r}`)}}var f=class{constructor(e){this.estimateStorageCost=(e,n)=>{let a=e.reduce((h,w)=>h+w.size,0)*n*1e3;return{sol:a/1e9,lamports:a}};this.rpcUrl=O(e.environment)}async createDeposit({payer:e,file:n,durationDays:t,signTransaction:s,userEmail:a}){console.log("Creating deposit transaction with environment:",this.rpcUrl);let o=new T.Connection(this.rpcUrl,"confirmed");return await U({file:n,duration:t*v,payer:e,connection:o,signTransaction:s,userEmail:a})}async getUserUploadHistory(e){return await P(e)}};var H=r=>new f({environment:r||"testnet"});0&&(module.exports={Client,Environment,createDepositTxn,fetchUserDepositHistory,getRpcUrl,useDeposit});
+"use strict";var P=Object.defineProperty;var F=Object.getOwnPropertyDescriptor;var B=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var H=(r,e)=>{for(var o in e)P(r,o,{get:e[o],enumerable:!0})},L=(r,e,o,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of B(e))!_.call(r,n)&&n!==o&&P(r,n,{get:()=>e[n],enumerable:!(t=F(e,n))||t.enumerable});return r};var q=r=>L(P({},"__esModule",{value:!0}),r);var M={};H(M,{Client:()=>g,Environment:()=>$,createDepositTxn:()=>D,fetchUserDepositHistory:()=>C,fetchUserUploadHistory:()=>C,getRpcUrl:()=>N,getStorageRenewalCost:()=>I,getUserUploadHistory:()=>C,renewStorageTxn:()=>k,useDeposit:()=>z,useUpload:()=>z});module.exports=q(M);var x=require("@solana/web3.js");var l=typeof window<"u"&&window.location.hostname==="localhost"?"http://localhost:5040":"https://storacha-solana-sdk-bshc.onrender.com",O=86400,j=1e9;var p=require("@solana/web3.js");async function D({file:r,duration:e,payer:o,connection:t,signTransaction:n,userEmail:i}){try{let a=new FormData;r.forEach(s=>a.append("file",s)),a.append("duration",e.toString()),a.append("publicKey",o.toBase58()),i&&a.append("userEmail",i);let d=r.length>1,y,m=await fetch(`${l}/api/solana/deposit`,{method:"POST",body:a});if(!m.ok)throw new Error("Failed to get deposit instructions");let c=await m.json();if(!c.instructions||!c.instructions.length)throw new Error("No instructions from deposit API");let S=await t.getLatestBlockhash("confirmed"),u=c.instructions[0],w=new p.TransactionInstruction({programId:new p.PublicKey(u.programId),keys:u.keys.map(s=>({pubkey:new p.PublicKey(s.pubkey),isSigner:s.isSigner,isWritable:s.isWritable})),data:Buffer.from(u.data,"base64")}),b=new p.Transaction;b.recentBlockhash=S.blockhash,b.feePayer=o,b.add(w);let v=await n(b),R;try{R=await t.sendRawTransaction(v.serialize(),{skipPreflight:!1,preflightCommitment:"confirmed"})}catch(s){throw s instanceof p.SendTransactionError?(s.logs??[]).some(A=>A.includes("already in use"))?new Error("This file has already been uploaded. You can find it in your dashboard."):new Error("Transaction failed during simulation. Please try again."):s}let E=await t.confirmTransaction({signature:R,blockhash:S.blockhash,lastValidBlockHeight:S.lastValidBlockHeight},"confirmed");if(E.value.err)throw console.error("Failed to confirm this transaction:",E.value.err),new Error(`Transaction failed: ${JSON.stringify(E.value.err)}`);try{await fetch(`${l}/api/user/update-transaction-hash`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:c.cid,transactionHash:R})})}catch(s){console.warn("Failed to update transaction hash:",s)}c.error&&(y=c.error);let U=new FormData;r.forEach(s=>U.append("file",s));let h;if(d?h=await fetch(`${l}/api/user/upload-files?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:U}):h=await fetch(`${l}/api/user/upload-file?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:U}),!h.ok){let s="Unknown error";try{let T=await h.json();s=T.message||T.error||s}catch{}throw new Error("Deposit API error: "+s)}let f=await h?.json();return{signature:R,success:!0,cid:c.cid,url:f.object.url,message:f.object.message,fileInfo:f.object?{filename:f.object.fileInfo?.filename||"",size:f?.object?.fileInfo?.size||0,uploadedAt:f?.object?.fileInfo?.uploadedAt||"",type:f?.object?.fileInfo?.type||""}:void 0}}catch(a){return console.error(a),a instanceof Error&&(console.error("Error name:",a.name),console.error("Error message:",a.message),console.error("Error stack:",a.stack)),{signature:"",success:!1,cid:"",url:"",message:"",fileInfo:void 0,error:a instanceof Error?a.message:"Unknown error occurred"}}}async function I(r,e){try{let o=await fetch(`${l}/api/user/renewal-cost?cid=${encodeURIComponent(r)}&duration=${e}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!o.ok){let t=await o.json();throw new Error(t.message||"Failed to get storage renewal cost")}return await o.json()}catch(o){return console.error("Failed to get storage renewal cost",o),null}}async function k({cid:r,duration:e,payer:o,connection:t,signTransaction:n}){let i=await fetch(`${l}/api/user/renew-storage`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:r,duration:e,publicKey:o.toString()})});if(!i.ok){let u=await i.json().catch(()=>({}));throw new Error(u.message||"Failed to create renewal transaction")}let a=await i.json(),d=new p.Transaction;a.instructions.forEach(u=>{d.add({programId:new p.PublicKey(u.programId),keys:u.keys.map(w=>({pubkey:new p.PublicKey(w.pubkey),isSigner:w.isSigner,isWritable:w.isWritable})),data:Buffer.from(u.data,"base64")})});let{blockhash:y}=await t.getLatestBlockhash();d.recentBlockhash=y,d.feePayer=o;let m=await n(d),c=await t.sendRawTransaction(m.serialize());return await t.confirmTransaction(c,"confirmed"),(await fetch(`${l}/api/user/confirm-renewal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:r,duration:e,transactionHash:c})})).ok||console.error("Failed to confirm renewal"),{success:!0,cid:r,signature:c,url:`https://w3s.link/ipfs/${r}`,message:"Storage renewed successfully"}}async function C(r,e={}){if(!r||typeof r!="string")throw new Error("User address is required and must be a string");let o=e.url||l;try{let t=await fetch(`${o}/api/user/user-upload-history?userAddress=${encodeURIComponent(r)}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!t.ok){let i=await t.json().catch(()=>({}));throw new Error(i.message||`Failed to fetch upload history: ${t.status} ${t.statusText}`)}let n=await t.json();if(typeof n!="object"||n===null)throw new Error("Invalid response format from server");if(typeof n.userAddress!="string")throw new Error("Invalid userAddress in response");return n}catch(t){throw t instanceof Error?t:new Error("Unknown error occurred while fetching upload history")}}var $=(t=>(t.mainnet="mainnet-beta",t.testnet="testnet",t.devnet="devnet",t))($||{});function N(r){switch(r){case"mainnet-beta":return"https://api.mainnet-beta.solana.com";case"testnet":return"https://api.testnet.solana.com";case"devnet":return"https://api.devnet.solana.com";default:throw new Error(`Unsupported environment: ${r}`)}}var g=class{constructor(e){this.rpcUrl=N(e.environment)}async createDeposit({payer:e,file:o,durationDays:t,signTransaction:n,userEmail:i}){console.log("Creating deposit transaction with environment:",this.rpcUrl);let a=new x.Connection(this.rpcUrl,"confirmed");return await D({file:o,duration:t*O,payer:e,connection:a,signTransaction:n,userEmail:i})}async estimateStorageCost(e,o){let t=e.reduce((m,c)=>m+c.size,0),n=Math.floor(o/86400),i=await fetch(`${l}/api/user/get-quote?size=${t}&duration=${n}`);if(!i.ok)throw new Error("Failed to get storage cost estimate");let{quote:a}=await i.json(),d=a.totalCost;return{sol:d/j,lamports:d}}async getUserUploadHistory(e){return await C(e)}async getStorageRenewalCost(e,o){return await I(e,o)}async renewStorageDuration({cid:e,duration:o,payer:t,signTransaction:n}){let i=new x.Connection(this.rpcUrl,"confirmed");return await k({cid:e,duration:o,payer:t,connection:i,signTransaction:n})}async getSolPrice(){let e=await fetch(`${l}/api/user/sol-price`);if(!e.ok)throw new Error("Couldn't fetch SOL price");return(await e.json()).price}};var z=r=>new g({environment:r||"testnet"});0&&(module.exports={Client,Environment,createDepositTxn,fetchUserDepositHistory,fetchUserUploadHistory,getRpcUrl,getStorageRenewalCost,getUserUploadHistory,renewStorageTxn,useDeposit,useUpload});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/constants.ts","../src/depositHistory.ts","../src/payment.ts","../src/hooks.ts"],"sourcesContent":["export * from \"./client\"\nexport * from \"./types\"\nexport * from \"./payment\"\nexport * from \"./hooks\"\nexport * from \"./depositHistory\"\n","import { Connection, PublicKey } from '@solana/web3.js';\nimport { DAY_TIME_IN_SECONDS } from './constants';\nimport { fetchUserDepositHistory } from './depositHistory';\nimport { createDepositTxn } from './payment';\nimport { CreateDepositArgs, UploadResult } from './types';\n\nexport enum Environment {\n  mainnet = 'mainnet-beta',\n  testnet = 'testnet',\n  devnet = 'devnet',\n}\n\nexport function getRpcUrl(env: Environment): string {\n  switch (env) {\n    case Environment.mainnet:\n      return 'https://api.mainnet-beta.solana.com';\n    case Environment.testnet:\n      return 'https://api.testnet.solana.com';\n    case Environment.devnet:\n      return 'https://api.devnet.solana.com';\n    default:\n      throw new Error(`Unsupported environment: ${env}`);\n  }\n}\n\nexport interface ClientOptions {\n  /** Solana RPC endpoint to use for chain interactions */\n  environment: Environment;\n}\n\nexport interface DepositParams\n  extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {\n  /** Wallet public key of the payer */\n  payer: PublicKey;\n  /** File(s) to be stored */\n  file: File[];\n  /** Duration in days to store the data */\n  durationDays: number;\n}\n\n/**\n * Solana Storage Client — simplified (no fee estimation)\n */\nexport class Client {\n  private rpcUrl: string;\n\n  constructor(options: ClientOptions) {\n    this.rpcUrl = getRpcUrl(options.environment);\n  }\n\n  /**\n   * Creates a deposit transaction ready to be signed & sent by user's wallet.\n   *\n   * @param {Object} params\n   * @param {PublicKey} params.payer - The public key (wallet address) of the connected wallet.\n   * @param {File} params.file - The file to be uploaded.\n   * @param {number} params.durationDays - How long (in days) the file should be stored.\n   * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction -\n   *   A callback function to authorize the transaction via the Solana wallet library.\n   *\n   * @example\n   * const { publicKey, signTransaction } = useSolanaWallet();\n   * const result = await createDeposit({\n   *   payer: publicKey,\n   *   file,\n   *   durationDays: 30,\n   *   signTransaction,\n   * });\n   *\n   * @returns {Promise<UploadResult>} The upload result after transaction is processed.\n   */\n  async createDeposit({\n    payer,\n    file,\n    durationDays,\n    signTransaction,\n    userEmail,\n  }: DepositParams): Promise<UploadResult> {\n    console.log('Creating deposit transaction with environment:', this.rpcUrl);\n    const connection = new Connection(this.rpcUrl, 'confirmed');\n\n    return await createDepositTxn({\n      file,\n      duration: durationDays * DAY_TIME_IN_SECONDS,\n      payer,\n      connection,\n      signTransaction,\n      userEmail,\n    });\n  }\n\n  /**\n   * estimates the cost for a file based on the amount of days it should be stored for\n   * @param {File} file - a file to be uploaded\n   * @param {number} duration - how long (in seconds) the file should be stored for\n   */\n  estimateStorageCost = (file: File[], duration: number) => {\n    const ratePerBytePerDay = 1000; // this would be obtained from the program config later\n    const fileSizeInBytes = file.reduce((acc, f) => acc + f.size, 0);\n    const totalLamports = fileSizeInBytes * duration * ratePerBytePerDay;\n    const totalSOL = totalLamports / 1_000_000_000;\n\n    return {\n      sol: totalSOL,\n      lamports: totalLamports,\n    };\n  };\n\n  async getUserUploadHistory(userAddress: string) {\n    const response = await fetchUserDepositHistory(userAddress);\n    return response;\n  }\n}\n","const { NODE_ENV } = process.env;\n\nexport const ENDPOINT =\n  NODE_ENV === 'development'\n    ? 'http://localhost:5040'\n    : 'https://storacha-solana-sdk-bshc.onrender.com';\n\nexport const DAY_TIME_IN_SECONDS = 86400;\n","import { ENDPOINT } from './constants';\nimport { DepositHistoryResponse, ServerOptions } from './types';\n\n/**\n * Fetches the deposit history for a given user address from the backend\n *\n * @param userAddress - The wallet address of the user to fetch deposit history for\n * @param options - Optional server configuration\n * @returns Promise<DepositHistoryResponse> - The user's deposit history\n *\n * @example\n * ```typescript\n * const history = await fetchUserDepositHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');\n * console.log('User deposit history:', history.userHistory);\n * ```\n *\n * @throws {Error} When the user address is invalid or the request fails\n */\nexport async function fetchUserDepositHistory(\n  userAddress: string,\n  options: ServerOptions = {}\n): Promise<DepositHistoryResponse> {\n  // Validate user address\n  if (!userAddress || typeof userAddress !== 'string') {\n    throw new Error('User address is required and must be a string');\n  }\n\n  // Use ENDPOINT constant, or allow override via options\n  const baseUrl = options.url || ENDPOINT;\n\n  try {\n    const response = await fetch(\n      `${baseUrl}/api/user/user-upload-history?userAddress=${encodeURIComponent(userAddress)}`,\n      {\n        method: 'GET',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n      }\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json().catch(() => ({}));\n      throw new Error(\n        errorData.message ||\n          `Failed to fetch deposit history: ${response.status} ${response.statusText}`\n      );\n    }\n\n    const data: DepositHistoryResponse = await response.json();\n\n    // Validate response structure\n    if (typeof data !== 'object' || data === null) {\n      throw new Error('Invalid response format from server');\n    }\n\n    if (typeof data.userAddress !== 'string') {\n      throw new Error('Invalid userAddress in response');\n    }\n\n    return data;\n  } catch (error) {\n    if (error instanceof Error) {\n      throw error;\n    }\n    throw new Error('Unknown error occurred while fetching deposit history');\n  }\n}\n","import { Signature } from '@solana/kit';\nimport {\n  PublicKey,\n  Transaction,\n  TransactionInstruction,\n} from '@solana/web3.js';\nimport { ENDPOINT } from './constants';\nimport { CreateDepositArgs, DepositResult, UploadResult } from './types';\n\n/**\n * Calls the deposit API for on-chain storage and returns a Transaction\n * which must be signed and sent externally by the user.\n *\n * @param params - {\n *   cid: string;\n *   file: File;\n *   duration: number;\n *   payer: PublicKey;\n *   connection: Connection;\n * }\n * @returns Transaction\n */\nexport async function createDepositTxn({\n  file,\n  duration,\n  payer,\n  connection,\n  signTransaction,\n  userEmail,\n}: CreateDepositArgs): Promise<UploadResult> {\n  try {\n    const formData = new FormData();\n    file.forEach((f) => formData.append('file', f));\n    formData.append('duration', duration.toString());\n    formData.append('publicKey', payer.toBase58());\n    if (userEmail) {\n      formData.append('userEmail', userEmail);\n    }\n\n    const isMultipleFiles = file.length > 1;\n\n    let uploadErr;\n\n    const depositReq = await fetch(`${ENDPOINT}/api/solana/deposit`, {\n      method: 'POST',\n      body: formData,\n    });\n    if (!depositReq.ok) throw new Error('Failed to get deposit instructions');\n\n    const depositRes: DepositResult = await depositReq.json();\n    if (!depositRes.instructions || !depositRes.instructions.length)\n      throw new Error('No instructions from deposit API');\n\n    const latestBlockhash = await connection.getLatestBlockhash('confirmed');\n    const instructions = depositRes.instructions[0];\n\n    const depositInstruction = new TransactionInstruction({\n      programId: new PublicKey(instructions.programId),\n      keys: instructions.keys.map((k) => ({\n        pubkey: new PublicKey(k.pubkey),\n        isSigner: k.isSigner,\n        isWritable: k.isWritable,\n      })),\n      data: Buffer.from(instructions.data, 'base64'),\n    });\n\n    const tx = new Transaction();\n    tx.recentBlockhash = latestBlockhash.blockhash;\n    tx.feePayer = payer;\n    tx.add(depositInstruction);\n\n    const signedTx = await signTransaction(tx);\n    const signature = await connection.sendRawTransaction(\n      signedTx.serialize(),\n      {\n        skipPreflight: false, // not sure we should be disabling this verification step\n        preflightCommitment: 'confirmed',\n      }\n    );\n    const confirmation = await connection.confirmTransaction(\n      {\n        signature,\n        blockhash: latestBlockhash.blockhash,\n        lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,\n      },\n      'confirmed'\n    );\n\n    if (confirmation.value.err) {\n      console.error(\n        'Failed to confirm this transaction:',\n        confirmation.value.err\n      );\n      throw new Error(\n        `Transaction failed: ${JSON.stringify(confirmation.value.err)}`\n      );\n    }\n\n    try {\n      await fetch(`${ENDPOINT}/api/user/update-transaction-hash`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({\n          cid: depositRes.cid,\n          transactionHash: signature,\n        }),\n      });\n    } catch (err) {\n      console.warn('Failed to update transaction hash:', err);\n    }\n\n    if (depositRes.error) {\n      uploadErr = depositRes.error;\n    }\n\n    const uploadForm = new FormData();\n    file.forEach((f) => uploadForm.append('file', f));\n\n    let fileUploadReq;\n    // calls the upload functionality on our server with the file when deposit is succesful\n    if (isMultipleFiles) {\n      fileUploadReq = await fetch(\n        `${ENDPOINT}/api/user/upload-files?cid=${encodeURIComponent(depositRes.cid)}`,\n        {\n          method: 'POST',\n          body: uploadForm,\n        }\n      );\n    } else {\n      fileUploadReq = await fetch(\n        `${ENDPOINT}/api/user/upload-file?cid=${encodeURIComponent(depositRes.cid)}`,\n        {\n          method: 'POST',\n          body: uploadForm,\n        }\n      );\n    }\n\n    if (!fileUploadReq.ok) {\n      let err = 'Unknown error';\n      try {\n        const data: DepositResult = await fileUploadReq.json();\n        err = data.message || data.error || err;\n      } catch {}\n      throw new Error('Deposit API error: ' + err);\n    }\n\n    const fileUploadRes: Pick<DepositResult, 'object' | 'cid' | 'message'> =\n      await fileUploadReq?.json();\n\n    return {\n      signature: signature as Signature,\n      success: true,\n      cid: depositRes.cid,\n      url: fileUploadRes.object.url,\n      message: fileUploadRes.object.message,\n      fileInfo: fileUploadRes.object\n        ? {\n            filename: fileUploadRes.object.fileInfo?.filename || '',\n            size: fileUploadRes?.object?.fileInfo?.size || 0,\n            uploadedAt: fileUploadRes?.object?.fileInfo?.uploadedAt || '',\n            type: fileUploadRes?.object?.fileInfo?.type || '',\n          }\n        : undefined,\n    };\n  } catch (error) {\n    console.error(error);\n    if (error instanceof Error) {\n      console.error('Error name:', error.name);\n      console.error('Error message:', error.message);\n      console.error('Error stack:', error.stack);\n    }\n\n    return {\n      signature: '' as Signature,\n      success: false,\n      cid: '',\n      url: '',\n      message: '',\n      fileInfo: undefined,\n      error: error instanceof Error ? error.message : 'Unknown error occurred',\n    };\n  }\n}\n","import { Client, ClientOptions } from './client';\n\nexport const useDeposit = (environment: ClientOptions['environment']) => {\n  const client = new Client({ environment: environment || 'testnet' });\n  return client;\n};\n"],"mappings":"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","names":["index_exports","__export","Client","Environment","createDepositTxn","fetchUserDepositHistory","getRpcUrl","useDeposit","__toCommonJS","import_web3","NODE_ENV","ENDPOINT","DAY_TIME_IN_SECONDS","fetchUserDepositHistory","userAddress","options","baseUrl","ENDPOINT","response","errorData","data","error","import_web3","createDepositTxn","file","duration","payer","connection","signTransaction","userEmail","formData","f","isMultipleFiles","uploadErr","depositReq","ENDPOINT","depositRes","latestBlockhash","instructions","depositInstruction","k","tx","signedTx","signature","confirmation","err","uploadForm","fileUploadReq","data","fileUploadRes","error","Environment","getRpcUrl","env","Client","options","file","duration","totalLamports","acc","f","payer","durationDays","signTransaction","userEmail","connection","createDepositTxn","DAY_TIME_IN_SECONDS","userAddress","fetchUserDepositHistory","useDeposit","environment","Client"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/constants.ts","../src/payment.ts","../src/upload-history.ts","../src/hooks.ts"],"sourcesContent":["export * from './client';\nexport * from './hooks';\nexport * from './payment';\nexport * from './types';\nexport * from './upload-history';\n","import { Connection, PublicKey } from '@solana/web3.js';\nimport {\n  DAY_TIME_IN_SECONDS,\n  ENDPOINT,\n  ONE_BILLION_LAMPORTS,\n} from './constants';\nimport {\n  createDepositTxn,\n  getStorageRenewalCost,\n  renewStorageTxn,\n} from './payment';\nimport {\n  CreateDepositArgs,\n  StorageRenewalCost,\n  StorageRenewalParams,\n  UploadResult,\n} from './types';\nimport { getUserUploadHistory } from './upload-history';\n\nexport enum Environment {\n  mainnet = 'mainnet-beta',\n  testnet = 'testnet',\n  devnet = 'devnet',\n}\n\nexport function getRpcUrl(env: Environment): string {\n  switch (env) {\n    case Environment.mainnet:\n      return 'https://api.mainnet-beta.solana.com';\n    case Environment.testnet:\n      return 'https://api.testnet.solana.com';\n    case Environment.devnet:\n      return 'https://api.devnet.solana.com';\n    default:\n      throw new Error(`Unsupported environment: ${env}`);\n  }\n}\n\nexport interface ClientOptions {\n  /** Solana RPC endpoint to use for chain interactions */\n  environment: Environment;\n}\n\nexport interface UploadParams extends Pick<\n  CreateDepositArgs,\n  'signTransaction' | 'userEmail'\n> {\n  /** Wallet public key of the payer */\n  payer: PublicKey;\n  /** File(s) to be stored */\n  file: File[];\n  /** Duration in days to store the data */\n  durationDays: number;\n}\n\n/**\n * @deprecated Use {@link UploadParams} instead.\n */\nexport type DepositParams = UploadParams;\n\n/**\n * Solana Storage Client — simplified (no fee estimation)\n */\nexport class Client {\n  private rpcUrl: string;\n\n  constructor(options: ClientOptions) {\n    this.rpcUrl = getRpcUrl(options.environment);\n  }\n\n  /**\n   * Creates a deposit transaction ready to be signed & sent by user's wallet.\n   *\n   * @param {Object} params\n   * @param {PublicKey} params.payer - The public key (wallet address) of the connected wallet.\n   * @param {File} params.file - The file to be uploaded.\n   * @param {number} params.durationDays - How long (in days) the file should be stored.\n   * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction -\n   *   A callback function to authorize the transaction via the Solana wallet library.\n   *\n   * @example\n   * const { publicKey, signTransaction } = useSolanaWallet();\n   * const result = await createDeposit({\n   *   payer: publicKey,\n   *   file,\n   *   durationDays: 30,\n   *   signTransaction,\n   * });\n   *\n   * @returns {Promise<UploadResult>} The upload result after transaction is processed.\n   */\n  async createDeposit({\n    payer,\n    file,\n    durationDays,\n    signTransaction,\n    userEmail,\n  }: UploadParams): Promise<UploadResult> {\n    console.log('Creating deposit transaction with environment:', this.rpcUrl);\n    const connection = new Connection(this.rpcUrl, 'confirmed');\n\n    return await createDepositTxn({\n      file,\n      duration: durationDays * DAY_TIME_IN_SECONDS,\n      payer,\n      connection,\n      signTransaction,\n      userEmail,\n    });\n  }\n\n  /**\n   * estimates the cost for a file based on the amount of days it should be stored for\n   * @param {File} file - a file to be uploaded\n   * @param {number} duration - how long (in seconds) the file should be stored for\n   */\n  async estimateStorageCost(file: File[], duration: number) {\n    const fileSizeInBytes = file.reduce((acc, f) => acc + f.size, 0);\n    const durationInDays = Math.floor(duration / 86400); // convert seconds to day\n\n    const response = await fetch(\n      `${ENDPOINT}/api/user/get-quote?size=${fileSizeInBytes}&duration=${durationInDays}`\n    );\n\n    if (!response.ok) throw new Error('Failed to get storage cost estimate');\n\n    const { quote } = await response.json();\n    const totalLamports = quote.totalCost;\n    const totalSOL = totalLamports / ONE_BILLION_LAMPORTS;\n\n    return {\n      sol: totalSOL,\n      lamports: totalLamports,\n    };\n  }\n\n  async getUserUploadHistory(userAddress: string) {\n    const response = await getUserUploadHistory(userAddress);\n    return response;\n  }\n\n  /**\n   * Get cost estimate for renewing storage duration\n   *\n   * @param {string} cid - Content identifier of the file to renew\n   * @param {number} duration - Number of additional days to extend storage\n   *\n   * @example\n   * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);\n   * console.log(`Renewal cost: ${quote.costInSOL} SOL`);\n   *\n   * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details\n   */\n  async getStorageRenewalCost(\n    cid: string,\n    duration: number\n  ): Promise<StorageRenewalCost | null> {\n    return await getStorageRenewalCost(cid, duration);\n  }\n\n  /**\n   * Renew storage for an existing deposit\n   *\n   * @param {Object} params\n   * @param {string} params.cid - Content identifier of the file to renew\n   * @param {number} params.duration - Number of additional days to extend storage\n   * @param {PublicKey} params.payer - Wallet public key paying for the renewal\n   * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback\n   *\n   * @example\n   * const { publicKey, signTransaction } = useSolanaWallet();\n   * const result = await client.renewStorage({\n   *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',\n   *   duration: 30,\n   *   payer: publicKey,\n   *   signTransaction,\n   * });\n   *\n   * @returns {Promise<UploadResult>} Result of the renewal transaction\n   */\n  async renewStorageDuration({\n    cid,\n    duration,\n    payer,\n    signTransaction,\n  }: StorageRenewalParams): Promise<UploadResult> {\n    const connection = new Connection(this.rpcUrl, 'confirmed');\n\n    return await renewStorageTxn({\n      cid,\n      duration,\n      payer,\n      connection,\n      signTransaction,\n    });\n  }\n\n  /**\n   * Gets the current SOL/USD price\n   *\n   * @example\n   * const { price } = await client.getSolPrice();\n   * console.log(`SOL price: $${price}`);\n   *\n   * @returns {Promise<{ price: number }>} Current SOL price in USD\n   */\n  async getSolPrice(): Promise<{ price: number }> {\n    const request = await fetch(`${ENDPOINT}/api/user/sol-price`);\n    if (!request.ok) throw new Error(\"Couldn't fetch SOL price\");\n    const data = await request.json();\n    return data.price;\n  }\n}\n","export const ENDPOINT =\n  typeof window !== 'undefined' && window.location.hostname === 'localhost'\n    ? 'http://localhost:5040'\n    : 'https://storacha-solana-sdk-bshc.onrender.com';\n\nexport const DAY_TIME_IN_SECONDS = 86400;\n\n/** 1 SOL in Lamports */\nexport const ONE_BILLION_LAMPORTS = 1_000_000_000;\n","import { Signature } from '@solana/kit';\nimport {\n  PublicKey,\n  SendTransactionError,\n  Transaction,\n  TransactionInstruction,\n} from '@solana/web3.js';\nimport { ENDPOINT } from './constants';\nimport {\n  CreateDepositArgs,\n  DepositResult,\n  RenewStorageDurationArgs,\n  StorageRenewalCost,\n  StorageRenewalResult,\n  UploadResult,\n} from './types';\n\n/**\n * Calls the deposit API for on-chain storage and returns a Transaction\n * which must be signed and sent externally by the user.\n *\n * @param params - {\n *   cid: string;\n *   file: File;\n *   duration: number;\n *   payer: PublicKey;\n *   connection: Connection;\n * }\n * @returns Transaction\n */\nexport async function createDepositTxn({\n  file,\n  duration,\n  payer,\n  connection,\n  signTransaction,\n  userEmail,\n}: CreateDepositArgs): Promise<UploadResult> {\n  try {\n    const formData = new FormData();\n    file.forEach((f) => formData.append('file', f));\n    formData.append('duration', duration.toString());\n    formData.append('publicKey', payer.toBase58());\n    if (userEmail) {\n      formData.append('userEmail', userEmail);\n    }\n\n    const isMultipleFiles = file.length > 1;\n\n    let uploadErr;\n\n    const depositReq = await fetch(`${ENDPOINT}/api/solana/deposit`, {\n      method: 'POST',\n      body: formData,\n    });\n    if (!depositReq.ok) throw new Error('Failed to get deposit instructions');\n\n    const depositRes: DepositResult = await depositReq.json();\n    if (!depositRes.instructions || !depositRes.instructions.length)\n      throw new Error('No instructions from deposit API');\n\n    const latestBlockhash = await connection.getLatestBlockhash('confirmed');\n    const instructions = depositRes.instructions[0];\n\n    const depositInstruction = new TransactionInstruction({\n      programId: new PublicKey(instructions.programId),\n      keys: instructions.keys.map((k) => ({\n        pubkey: new PublicKey(k.pubkey),\n        isSigner: k.isSigner,\n        isWritable: k.isWritable,\n      })),\n      data: Buffer.from(instructions.data, 'base64'),\n    });\n\n    const tx = new Transaction();\n    tx.recentBlockhash = latestBlockhash.blockhash;\n    tx.feePayer = payer;\n    tx.add(depositInstruction);\n\n    const signedTx = await signTransaction(tx);\n    let signature: string;\n\n    try {\n      signature = await connection.sendRawTransaction(signedTx.serialize(), {\n        skipPreflight: false, // not sure we should be disabling this verification step\n        preflightCommitment: 'confirmed',\n      });\n    } catch (err) {\n      if (err instanceof SendTransactionError) {\n        const logs = err.logs ?? [];\n\n        const isDuplicateUpload = logs.some((log) =>\n          log.includes('already in use')\n        );\n\n        if (isDuplicateUpload) {\n          throw new Error(\n            'This file has already been uploaded. You can find it in your dashboard.'\n          );\n        }\n\n        throw new Error(\n          'Transaction failed during simulation. Please try again.'\n        );\n      }\n\n      throw err;\n    }\n    const confirmation = await connection.confirmTransaction(\n      {\n        signature,\n        blockhash: latestBlockhash.blockhash,\n        lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,\n      },\n      'confirmed'\n    );\n\n    if (confirmation.value.err) {\n      console.error(\n        'Failed to confirm this transaction:',\n        confirmation.value.err\n      );\n      throw new Error(\n        `Transaction failed: ${JSON.stringify(confirmation.value.err)}`\n      );\n    }\n\n    try {\n      await fetch(`${ENDPOINT}/api/user/update-transaction-hash`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({\n          cid: depositRes.cid,\n          transactionHash: signature,\n        }),\n      });\n    } catch (err) {\n      console.warn('Failed to update transaction hash:', err);\n    }\n\n    if (depositRes.error) {\n      uploadErr = depositRes.error;\n    }\n\n    const uploadForm = new FormData();\n    file.forEach((f) => uploadForm.append('file', f));\n\n    let fileUploadReq;\n    // calls the upload functionality on our server with the file when deposit is successful\n    if (isMultipleFiles) {\n      fileUploadReq = await fetch(\n        `${ENDPOINT}/api/user/upload-files?cid=${encodeURIComponent(\n          depositRes.cid\n        )}`,\n        {\n          method: 'POST',\n          body: uploadForm,\n        }\n      );\n    } else {\n      fileUploadReq = await fetch(\n        `${ENDPOINT}/api/user/upload-file?cid=${encodeURIComponent(\n          depositRes.cid\n        )}`,\n        {\n          method: 'POST',\n          body: uploadForm,\n        }\n      );\n    }\n\n    if (!fileUploadReq.ok) {\n      let err = 'Unknown error';\n      try {\n        const data: DepositResult = await fileUploadReq.json();\n        err = data.message || data.error || err;\n      } catch {}\n      throw new Error('Deposit API error: ' + err);\n    }\n\n    const fileUploadRes: Pick<DepositResult, 'object' | 'cid' | 'message'> =\n      await fileUploadReq?.json();\n\n    return {\n      signature: signature as Signature,\n      success: true,\n      cid: depositRes.cid,\n      url: fileUploadRes.object.url,\n      message: fileUploadRes.object.message,\n      fileInfo: fileUploadRes.object\n        ? {\n            filename: fileUploadRes.object.fileInfo?.filename || '',\n            size: fileUploadRes?.object?.fileInfo?.size || 0,\n            uploadedAt: fileUploadRes?.object?.fileInfo?.uploadedAt || '',\n            type: fileUploadRes?.object?.fileInfo?.type || '',\n          }\n        : undefined,\n    };\n  } catch (error) {\n    console.error(error);\n    if (error instanceof Error) {\n      console.error('Error name:', error.name);\n      console.error('Error message:', error.message);\n      console.error('Error stack:', error.stack);\n    }\n\n    return {\n      signature: '' as Signature,\n      success: false,\n      cid: '',\n      url: '',\n      message: '',\n      fileInfo: undefined,\n      error: error instanceof Error ? error.message : 'Unknown error occurred',\n    };\n  }\n}\n\n/**\n * Get cost estimate for renewing storage duration\n *\n * @param {string} cid - Content identifier of the uploaded data to renew\n * @param {number} duration - Number of additional days to extend storage\n *\n * @example\n * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);\n * console.log(`Renewal cost: ${quote.costInSOL} SOL`);\n *\n * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details\n */\nexport async function getStorageRenewalCost(\n  cid: string,\n  duration: number\n): Promise<StorageRenewalCost | null> {\n  try {\n    const request = await fetch(\n      `${ENDPOINT}/api/user/renewal-cost?cid=${encodeURIComponent(\n        cid\n      )}&duration=${duration}`,\n      {\n        method: 'GET',\n        headers: { 'Content-Type': 'application/json' },\n      }\n    );\n\n    if (!request.ok) {\n      const response = await request.json();\n      throw new Error(response.message || 'Failed to get storage renewal cost');\n    }\n\n    return await request.json();\n  } catch (error) {\n    console.error('Failed to get storage renewal cost', error);\n    return null;\n  }\n}\n\n/**\n * Renew storage for an existing deposit\n *\n * @param {Object} params\n * @param {string} params.cid - Content identifier of the uploaded data to renew\n * @param {number} params.duration - Number of additional days to extend storage\n * @param {PublicKey} params.payer - Wallet public key paying for the renewal\n * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback\n *\n * @example\n * const { publicKey, signTransaction } = useSolanaWallet();\n * const result = await client.renewStorage({\n *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',\n *   additionalDays: 30,\n *   payer: publicKey,\n *   signTransaction,\n * });\n *\n * @returns {Promise<UploadResult>} Result of the renewal transaction\n */\nexport async function renewStorageTxn({\n  cid,\n  duration,\n  payer,\n  connection,\n  signTransaction,\n}: RenewStorageDurationArgs): Promise<UploadResult> {\n  const renewalTransactionIx = await fetch(\n    `${ENDPOINT}/api/user/renew-storage`,\n    {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        cid,\n        duration,\n        publicKey: payer.toString(),\n      }),\n    }\n  );\n\n  if (!renewalTransactionIx.ok) {\n    const errorData = await renewalTransactionIx.json().catch(() => ({}));\n    throw new Error(\n      errorData.message || 'Failed to create renewal transaction'\n    );\n  }\n\n  const renewalData: StorageRenewalResult = await renewalTransactionIx.json();\n  const transaction = new Transaction();\n\n  renewalData.instructions.forEach((ix) => {\n    transaction.add({\n      programId: new PublicKey(ix.programId),\n      keys: ix.keys.map((key) => ({\n        pubkey: new PublicKey(key.pubkey),\n        isSigner: key.isSigner,\n        isWritable: key.isWritable,\n      })),\n      data: Buffer.from(ix.data, 'base64'),\n    });\n  });\n\n  const { blockhash } = await connection.getLatestBlockhash();\n  transaction.recentBlockhash = blockhash;\n  transaction.feePayer = payer;\n\n  const signed = await signTransaction(transaction);\n  const signature = await connection.sendRawTransaction(signed.serialize());\n  await connection.confirmTransaction(signature, 'confirmed');\n\n  const confirmRenewalTx = await fetch(`${ENDPOINT}/api/user/confirm-renewal`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({\n      cid,\n      duration,\n      transactionHash: signature,\n    }),\n  });\n\n  if (!confirmRenewalTx.ok) {\n    console.error('Failed to confirm renewal');\n  }\n\n  return {\n    success: true,\n    cid,\n    signature: signature as Signature,\n    url: `https://w3s.link/ipfs/${cid}`,\n    message: 'Storage renewed successfully',\n  };\n}\n","import { ENDPOINT } from './constants';\nimport { ServerOptions, UploadHistoryResponse } from './types';\n\n/**\n * Get the upload history for a given user address from the server\n *\n * @param userAddress - The wallet address of the user to fetch upload history for\n * @param options - Optional server configuration\n * @returns Promise<UploadHistoryResponse> - The user's upload history\n *\n * @example\n * ```typescript\n * const history = await getUserUploadHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');\n * console.log('User upload history:', history.userHistory);\n * ```\n *\n * @throws {Error} When the user address is invalid or the request fails\n */\nexport async function getUserUploadHistory(\n  userAddress: string,\n  options: ServerOptions = {}\n): Promise<UploadHistoryResponse> {\n  // Validate user address\n  if (!userAddress || typeof userAddress !== 'string') {\n    throw new Error('User address is required and must be a string');\n  }\n\n  // Use ENDPOINT constant, or allow override via options\n  const baseUrl = options.url || ENDPOINT;\n\n  try {\n    const response = await fetch(\n      `${baseUrl}/api/user/user-upload-history?userAddress=${encodeURIComponent(userAddress)}`,\n      {\n        method: 'GET',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n      }\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json().catch(() => ({}));\n      throw new Error(\n        errorData.message ||\n          `Failed to fetch upload history: ${response.status} ${response.statusText}`\n      );\n    }\n\n    const data: UploadHistoryResponse = await response.json();\n\n    // Validate response structure\n    if (typeof data !== 'object' || data === null) {\n      throw new Error('Invalid response format from server');\n    }\n\n    if (typeof data.userAddress !== 'string') {\n      throw new Error('Invalid userAddress in response');\n    }\n\n    return data;\n  } catch (error) {\n    if (error instanceof Error) {\n      throw error;\n    }\n    throw new Error('Unknown error occurred while fetching upload history');\n  }\n}\n\n/**\n * @deprecated Use getUserUploadHistory instead\n */\nexport { getUserUploadHistory as fetchUserUploadHistory };\n\n/**\n * @deprecated Use getUserUploadHistory instead\n */\nexport { getUserUploadHistory as fetchUserDepositHistory };\n","import { Client, ClientOptions } from './client';\n\nexport const useUpload = (environment: ClientOptions['environment']) => {\n  const client = new Client({ environment: environment || 'testnet' });\n  return client;\n};\n\n/**\n * @deprecated Use {@link useUpload} instead.\n */\nexport { useUpload as useDeposit };\n"],"mappings":"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","names":["index_exports","__export","Client","Environment","createDepositTxn","getUserUploadHistory","getRpcUrl","getStorageRenewalCost","renewStorageTxn","useUpload","__toCommonJS","import_web3","ENDPOINT","DAY_TIME_IN_SECONDS","ONE_BILLION_LAMPORTS","import_web3","createDepositTxn","file","duration","payer","connection","signTransaction","userEmail","formData","f","isMultipleFiles","uploadErr","depositReq","ENDPOINT","depositRes","latestBlockhash","instructions","depositInstruction","k","tx","signedTx","signature","err","log","confirmation","uploadForm","fileUploadReq","data","fileUploadRes","error","getStorageRenewalCost","cid","request","response","renewStorageTxn","renewalTransactionIx","errorData","renewalData","transaction","ix","key","blockhash","signed","getUserUploadHistory","userAddress","options","baseUrl","ENDPOINT","response","errorData","data","error","Environment","getRpcUrl","env","Client","options","payer","file","durationDays","signTransaction","userEmail","connection","createDepositTxn","DAY_TIME_IN_SECONDS","duration","fileSizeInBytes","acc","f","durationInDays","response","ENDPOINT","quote","totalLamports","ONE_BILLION_LAMPORTS","userAddress","getUserUploadHistory","cid","getStorageRenewalCost","renewStorageTxn","request","useUpload","environment","Client"]}

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { Address, Signature } from '@solana/kit';
-import { PublicKey, Connection, Transaction } from '@solana/web3.js';
+import { PublicKey, Connection, Transaction as Transaction$1 } from '@solana/web3.js';
 
 interface ServerOptions {
-    /** URL pointing to the backend (mostly Storacha's) */
+    /** URL pointing to the server (mostly Storacha's) */
     url?: string;
 }
 /**
@@ -116,14 +116,49 @@ interface CreateDepositArgs extends Omit<OnChainDeposit, 'depositAmount' | 'depo
      * const {publickKey, signTransaction} = useSolanaWallet()
      * const signTransaction = await signTransaction(tx)
      * */
-    signTransaction: (tx: Transaction) => Promise<Transaction>;
+    signTransaction: (tx: Transaction$1) => Promise<Transaction$1>;
     /** Optional user email for expiration notifications */
     userEmail?: string;
 }
+/** Arguments for renewing storage duration */
+interface StorageRenewalParams extends Pick<CreateDepositArgs, 'payer' | 'signTransaction'> {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Duration in days to extend storage */
+    duration: number;
+}
+/** Internal arguments for renewStorageTxn */
+interface RenewStorageDurationArgs extends Pick<CreateDepositArgs, 'payer' | 'signTransaction' | 'connection'> {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Duration in days to extend storage */
+    duration: number;
+}
+/**
+ * Transaction record for an upload (initial deposit or renewal)
+ */
+interface Transaction {
+    /** Unique identifier for the transaction */
+    id: number;
+    /** ID of the associated deposit */
+    depositId: number;
+    /** Content identifier of the upload */
+    contentCid: string;
+    /** Solana transaction hash */
+    transactionHash: string;
+    /** Type of transaction: 'initial_deposit' | 'renewal' */
+    transactionType: string;
+    /** Amount paid in lamports */
+    amountInLamports: number;
+    /** Duration in days purchased */
+    durationDays: number;
+    /** Timestamp when the transaction was created */
+    createdAt: string;
+}
 /**
- * Individual deposit history entry from the backend
+ * Individual upload history entry from the server
  */
-interface DepositHistoryEntry {
+interface UploadHistory {
     /** Unique identifier for the deposit */
     id: number;
     /** User's wallet address (deposit key) */
@@ -156,16 +191,78 @@ interface DepositHistoryEntry {
     deletionStatus?: string;
     /** Timestamp when warning email was sent */
     warningSentAt?: string;
+    /** Optional array of all transactions for this upload */
+    transactions?: Transaction[];
 }
+/**
+ * @deprecated Use UploadHistory instead
+ */
+type DepositHistoryEntry = UploadHistory;
 /**
  * Response from the getUserUploadHistory endpoint
  */
-interface DepositHistoryResponse {
-    /** Array of deposit history entries */
-    userHistory: DepositHistoryEntry[] | null;
+interface UploadHistoryResponse {
+    /** Array of upload history entries */
+    userHistory: UploadHistory[] | null;
     /** The user address that was queried */
     userAddress: string;
 }
+/**
+ * @deprecated Use UploadHistoryResponse instead
+ */
+type DepositHistoryResponse = UploadHistoryResponse;
+/**
+ * Storage renewal cost estimation
+ */
+type StorageRenewalCost = {
+    /** New expiration date after renewal */
+    newExpirationDate: string;
+    /** Current expiration date before renewal */
+    currentExpirationDate: string;
+    /** Number of additional days being added */
+    additionalDays: string;
+    /** Cost of renewal in lamports */
+    costInLamports: number;
+    /** Cost of renewal in SOL */
+    costInSOL: number;
+    /** Details about the file being renewed */
+    fileDetails: {
+        /** Content identifier */
+        cid: string;
+        /** Name of the file */
+        fileName: string;
+        /** Size of the file in bytes */
+        fileSize: number;
+    };
+};
+/**
+ * Storage renewal transaction result
+ */
+type StorageRenewalResult = {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Status message about the renewal */
+    message: string;
+    /** Transaction instructions for the user to sign */
+    instructions: Array<{
+        programId: string;
+        keys: Array<{
+            pubkey: string;
+            isSigner: boolean;
+            isWritable: boolean;
+        }>;
+        data: string;
+    }>;
+    /** Number of additional days being added */
+    duration: number;
+    /** Cost breakdown for the renewal */
+    cost: {
+        /** Cost in lamports */
+        lamports: number;
+        /** Cost in SOL */
+        sol: number;
+    };
+};
 
 declare enum Environment {
     mainnet = "mainnet-beta",
@@ -177,7 +274,7 @@ interface ClientOptions {
     /** Solana RPC endpoint to use for chain interactions */
     environment: Environment;
 }
-interface DepositParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
+interface UploadParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
     /** Wallet public key of the payer */
     payer: PublicKey;
     /** File(s) to be stored */
@@ -185,6 +282,10 @@ interface DepositParams extends Pick<CreateDepositArgs, 'signTransaction' | 'use
     /** Duration in days to store the data */
     durationDays: number;
 }
+/**
+ * @deprecated Use {@link UploadParams} instead.
+ */
+type DepositParams = UploadParams;
 /**
  * Solana Storage Client — simplified (no fee estimation)
  */
@@ -212,19 +313,67 @@ declare class Client {
      *
      * @returns {Promise<UploadResult>} The upload result after transaction is processed.
      */
-    createDeposit({ payer, file, durationDays, signTransaction, userEmail, }: DepositParams): Promise<UploadResult>;
+    createDeposit({ payer, file, durationDays, signTransaction, userEmail, }: UploadParams): Promise<UploadResult>;
     /**
      * estimates the cost for a file based on the amount of days it should be stored for
      * @param {File} file - a file to be uploaded
      * @param {number} duration - how long (in seconds) the file should be stored for
      */
-    estimateStorageCost: (file: File[], duration: number) => {
+    estimateStorageCost(file: File[], duration: number): Promise<{
         sol: number;
-        lamports: number;
-    };
-    getUserUploadHistory(userAddress: string): Promise<DepositHistoryResponse>;
+        lamports: any;
+    }>;
+    getUserUploadHistory(userAddress: string): Promise<UploadHistoryResponse>;
+    /**
+     * Get cost estimate for renewing storage duration
+     *
+     * @param {string} cid - Content identifier of the file to renew
+     * @param {number} duration - Number of additional days to extend storage
+     *
+     * @example
+     * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);
+     * console.log(`Renewal cost: ${quote.costInSOL} SOL`);
+     *
+     * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details
+     */
+    getStorageRenewalCost(cid: string, duration: number): Promise<StorageRenewalCost | null>;
+    /**
+     * Renew storage for an existing deposit
+     *
+     * @param {Object} params
+     * @param {string} params.cid - Content identifier of the file to renew
+     * @param {number} params.duration - Number of additional days to extend storage
+     * @param {PublicKey} params.payer - Wallet public key paying for the renewal
+     * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback
+     *
+     * @example
+     * const { publicKey, signTransaction } = useSolanaWallet();
+     * const result = await client.renewStorage({
+     *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
+     *   duration: 30,
+     *   payer: publicKey,
+     *   signTransaction,
+     * });
+     *
+     * @returns {Promise<UploadResult>} Result of the renewal transaction
+     */
+    renewStorageDuration({ cid, duration, payer, signTransaction, }: StorageRenewalParams): Promise<UploadResult>;
+    /**
+     * Gets the current SOL/USD price
+     *
+     * @example
+     * const { price } = await client.getSolPrice();
+     * console.log(`SOL price: $${price}`);
+     *
+     * @returns {Promise<{ price: number }>} Current SOL price in USD
+     */
+    getSolPrice(): Promise<{
+        price: number;
+    }>;
 }
 
+declare const useUpload: (environment: ClientOptions["environment"]) => Client;
+
 /**
  * Calls the deposit API for on-chain storage and returns a Transaction
  * which must be signed and sent externally by the user.
@@ -239,24 +388,56 @@ declare class Client {
  * @returns Transaction
  */
 declare function createDepositTxn({ file, duration, payer, connection, signTransaction, userEmail, }: CreateDepositArgs): Promise<UploadResult>;
-
-declare const useDeposit: (environment: ClientOptions["environment"]) => Client;
+/**
+ * Get cost estimate for renewing storage duration
+ *
+ * @param {string} cid - Content identifier of the uploaded data to renew
+ * @param {number} duration - Number of additional days to extend storage
+ *
+ * @example
+ * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);
+ * console.log(`Renewal cost: ${quote.costInSOL} SOL`);
+ *
+ * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details
+ */
+declare function getStorageRenewalCost(cid: string, duration: number): Promise<StorageRenewalCost | null>;
+/**
+ * Renew storage for an existing deposit
+ *
+ * @param {Object} params
+ * @param {string} params.cid - Content identifier of the uploaded data to renew
+ * @param {number} params.duration - Number of additional days to extend storage
+ * @param {PublicKey} params.payer - Wallet public key paying for the renewal
+ * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback
+ *
+ * @example
+ * const { publicKey, signTransaction } = useSolanaWallet();
+ * const result = await client.renewStorage({
+ *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
+ *   additionalDays: 30,
+ *   payer: publicKey,
+ *   signTransaction,
+ * });
+ *
+ * @returns {Promise<UploadResult>} Result of the renewal transaction
+ */
+declare function renewStorageTxn({ cid, duration, payer, connection, signTransaction, }: RenewStorageDurationArgs): Promise<UploadResult>;
 
 /**
- * Fetches the deposit history for a given user address from the backend
+ * Get the upload history for a given user address from the server
  *
- * @param userAddress - The wallet address of the user to fetch deposit history for
+ * @param userAddress - The wallet address of the user to fetch upload history for
  * @param options - Optional server configuration
- * @returns Promise<DepositHistoryResponse> - The user's deposit history
+ * @returns Promise<UploadHistoryResponse> - The user's upload history
  *
  * @example
  * ```typescript
- * const history = await fetchUserDepositHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');
- * console.log('User deposit history:', history.userHistory);
+ * const history = await getUserUploadHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');
+ * console.log('User upload history:', history.userHistory);
  * ```
  *
  * @throws {Error} When the user address is invalid or the request fails
  */
-declare function fetchUserDepositHistory(userAddress: string, options?: ServerOptions): Promise<DepositHistoryResponse>;
+declare function getUserUploadHistory(userAddress: string, options?: ServerOptions): Promise<UploadHistoryResponse>;
 
-export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type ServerOptions, type UploadOptions, type UploadResult, type WalletItem, createDepositTxn, fetchUserDepositHistory, getRpcUrl, useDeposit };
+export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type RenewStorageDurationArgs, type ServerOptions, type StorageRenewalCost, type StorageRenewalParams, type StorageRenewalResult, type Transaction, type UploadHistory, type UploadHistoryResponse, type UploadOptions, type UploadParams, type UploadResult, type WalletItem, createDepositTxn, getUserUploadHistory as fetchUserDepositHistory, getUserUploadHistory as fetchUserUploadHistory, getRpcUrl, getStorageRenewalCost, getUserUploadHistory, renewStorageTxn, useUpload as useDeposit, useUpload };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { Address, Signature } from '@solana/kit';
-import { PublicKey, Connection, Transaction } from '@solana/web3.js';
+import { PublicKey, Connection, Transaction as Transaction$1 } from '@solana/web3.js';
 
 interface ServerOptions {
-    /** URL pointing to the backend (mostly Storacha's) */
+    /** URL pointing to the server (mostly Storacha's) */
     url?: string;
 }
 /**
@@ -116,14 +116,49 @@ interface CreateDepositArgs extends Omit<OnChainDeposit, 'depositAmount' | 'depo
      * const {publickKey, signTransaction} = useSolanaWallet()
      * const signTransaction = await signTransaction(tx)
      * */
-    signTransaction: (tx: Transaction) => Promise<Transaction>;
+    signTransaction: (tx: Transaction$1) => Promise<Transaction$1>;
     /** Optional user email for expiration notifications */
     userEmail?: string;
 }
+/** Arguments for renewing storage duration */
+interface StorageRenewalParams extends Pick<CreateDepositArgs, 'payer' | 'signTransaction'> {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Duration in days to extend storage */
+    duration: number;
+}
+/** Internal arguments for renewStorageTxn */
+interface RenewStorageDurationArgs extends Pick<CreateDepositArgs, 'payer' | 'signTransaction' | 'connection'> {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Duration in days to extend storage */
+    duration: number;
+}
+/**
+ * Transaction record for an upload (initial deposit or renewal)
+ */
+interface Transaction {
+    /** Unique identifier for the transaction */
+    id: number;
+    /** ID of the associated deposit */
+    depositId: number;
+    /** Content identifier of the upload */
+    contentCid: string;
+    /** Solana transaction hash */
+    transactionHash: string;
+    /** Type of transaction: 'initial_deposit' | 'renewal' */
+    transactionType: string;
+    /** Amount paid in lamports */
+    amountInLamports: number;
+    /** Duration in days purchased */
+    durationDays: number;
+    /** Timestamp when the transaction was created */
+    createdAt: string;
+}
 /**
- * Individual deposit history entry from the backend
+ * Individual upload history entry from the server
  */
-interface DepositHistoryEntry {
+interface UploadHistory {
     /** Unique identifier for the deposit */
     id: number;
     /** User's wallet address (deposit key) */
@@ -156,16 +191,78 @@ interface DepositHistoryEntry {
     deletionStatus?: string;
     /** Timestamp when warning email was sent */
     warningSentAt?: string;
+    /** Optional array of all transactions for this upload */
+    transactions?: Transaction[];
 }
+/**
+ * @deprecated Use UploadHistory instead
+ */
+type DepositHistoryEntry = UploadHistory;
 /**
  * Response from the getUserUploadHistory endpoint
  */
-interface DepositHistoryResponse {
-    /** Array of deposit history entries */
-    userHistory: DepositHistoryEntry[] | null;
+interface UploadHistoryResponse {
+    /** Array of upload history entries */
+    userHistory: UploadHistory[] | null;
     /** The user address that was queried */
     userAddress: string;
 }
+/**
+ * @deprecated Use UploadHistoryResponse instead
+ */
+type DepositHistoryResponse = UploadHistoryResponse;
+/**
+ * Storage renewal cost estimation
+ */
+type StorageRenewalCost = {
+    /** New expiration date after renewal */
+    newExpirationDate: string;
+    /** Current expiration date before renewal */
+    currentExpirationDate: string;
+    /** Number of additional days being added */
+    additionalDays: string;
+    /** Cost of renewal in lamports */
+    costInLamports: number;
+    /** Cost of renewal in SOL */
+    costInSOL: number;
+    /** Details about the file being renewed */
+    fileDetails: {
+        /** Content identifier */
+        cid: string;
+        /** Name of the file */
+        fileName: string;
+        /** Size of the file in bytes */
+        fileSize: number;
+    };
+};
+/**
+ * Storage renewal transaction result
+ */
+type StorageRenewalResult = {
+    /** Content identifier of the uploaded data to be renewed */
+    cid: string;
+    /** Status message about the renewal */
+    message: string;
+    /** Transaction instructions for the user to sign */
+    instructions: Array<{
+        programId: string;
+        keys: Array<{
+            pubkey: string;
+            isSigner: boolean;
+            isWritable: boolean;
+        }>;
+        data: string;
+    }>;
+    /** Number of additional days being added */
+    duration: number;
+    /** Cost breakdown for the renewal */
+    cost: {
+        /** Cost in lamports */
+        lamports: number;
+        /** Cost in SOL */
+        sol: number;
+    };
+};
 
 declare enum Environment {
     mainnet = "mainnet-beta",
@@ -177,7 +274,7 @@ interface ClientOptions {
     /** Solana RPC endpoint to use for chain interactions */
     environment: Environment;
 }
-interface DepositParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
+interface UploadParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
     /** Wallet public key of the payer */
     payer: PublicKey;
     /** File(s) to be stored */
@@ -185,6 +282,10 @@ interface DepositParams extends Pick<CreateDepositArgs, 'signTransaction' | 'use
     /** Duration in days to store the data */
     durationDays: number;
 }
+/**
+ * @deprecated Use {@link UploadParams} instead.
+ */
+type DepositParams = UploadParams;
 /**
  * Solana Storage Client — simplified (no fee estimation)
  */
@@ -212,19 +313,67 @@ declare class Client {
      *
      * @returns {Promise<UploadResult>} The upload result after transaction is processed.
      */
-    createDeposit({ payer, file, durationDays, signTransaction, userEmail, }: DepositParams): Promise<UploadResult>;
+    createDeposit({ payer, file, durationDays, signTransaction, userEmail, }: UploadParams): Promise<UploadResult>;
     /**
      * estimates the cost for a file based on the amount of days it should be stored for
      * @param {File} file - a file to be uploaded
      * @param {number} duration - how long (in seconds) the file should be stored for
      */
-    estimateStorageCost: (file: File[], duration: number) => {
+    estimateStorageCost(file: File[], duration: number): Promise<{
         sol: number;
-        lamports: number;
-    };
-    getUserUploadHistory(userAddress: string): Promise<DepositHistoryResponse>;
+        lamports: any;
+    }>;
+    getUserUploadHistory(userAddress: string): Promise<UploadHistoryResponse>;
+    /**
+     * Get cost estimate for renewing storage duration
+     *
+     * @param {string} cid - Content identifier of the file to renew
+     * @param {number} duration - Number of additional days to extend storage
+     *
+     * @example
+     * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);
+     * console.log(`Renewal cost: ${quote.costInSOL} SOL`);
+     *
+     * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details
+     */
+    getStorageRenewalCost(cid: string, duration: number): Promise<StorageRenewalCost | null>;
+    /**
+     * Renew storage for an existing deposit
+     *
+     * @param {Object} params
+     * @param {string} params.cid - Content identifier of the file to renew
+     * @param {number} params.duration - Number of additional days to extend storage
+     * @param {PublicKey} params.payer - Wallet public key paying for the renewal
+     * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback
+     *
+     * @example
+     * const { publicKey, signTransaction } = useSolanaWallet();
+     * const result = await client.renewStorage({
+     *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
+     *   duration: 30,
+     *   payer: publicKey,
+     *   signTransaction,
+     * });
+     *
+     * @returns {Promise<UploadResult>} Result of the renewal transaction
+     */
+    renewStorageDuration({ cid, duration, payer, signTransaction, }: StorageRenewalParams): Promise<UploadResult>;
+    /**
+     * Gets the current SOL/USD price
+     *
+     * @example
+     * const { price } = await client.getSolPrice();
+     * console.log(`SOL price: $${price}`);
+     *
+     * @returns {Promise<{ price: number }>} Current SOL price in USD
+     */
+    getSolPrice(): Promise<{
+        price: number;
+    }>;
 }
 
+declare const useUpload: (environment: ClientOptions["environment"]) => Client;
+
 /**
  * Calls the deposit API for on-chain storage and returns a Transaction
  * which must be signed and sent externally by the user.
@@ -239,24 +388,56 @@ declare class Client {
  * @returns Transaction
  */
 declare function createDepositTxn({ file, duration, payer, connection, signTransaction, userEmail, }: CreateDepositArgs): Promise<UploadResult>;
-
-declare const useDeposit: (environment: ClientOptions["environment"]) => Client;
+/**
+ * Get cost estimate for renewing storage duration
+ *
+ * @param {string} cid - Content identifier of the uploaded data to renew
+ * @param {number} duration - Number of additional days to extend storage
+ *
+ * @example
+ * const quote = await client.getRenewalQuote('bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi', 30);
+ * console.log(`Renewal cost: ${quote.costInSOL} SOL`);
+ *
+ * @returns {Promise<StorageRenewalCost | null>} Cost breakdown and expiration details
+ */
+declare function getStorageRenewalCost(cid: string, duration: number): Promise<StorageRenewalCost | null>;
+/**
+ * Renew storage for an existing deposit
+ *
+ * @param {Object} params
+ * @param {string} params.cid - Content identifier of the uploaded data to renew
+ * @param {number} params.duration - Number of additional days to extend storage
+ * @param {PublicKey} params.payer - Wallet public key paying for the renewal
+ * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction - Transaction signing callback
+ *
+ * @example
+ * const { publicKey, signTransaction } = useSolanaWallet();
+ * const result = await client.renewStorage({
+ *   cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
+ *   additionalDays: 30,
+ *   payer: publicKey,
+ *   signTransaction,
+ * });
+ *
+ * @returns {Promise<UploadResult>} Result of the renewal transaction
+ */
+declare function renewStorageTxn({ cid, duration, payer, connection, signTransaction, }: RenewStorageDurationArgs): Promise<UploadResult>;
 
 /**
- * Fetches the deposit history for a given user address from the backend
+ * Get the upload history for a given user address from the server
  *
- * @param userAddress - The wallet address of the user to fetch deposit history for
+ * @param userAddress - The wallet address of the user to fetch upload history for
  * @param options - Optional server configuration
- * @returns Promise<DepositHistoryResponse> - The user's deposit history
+ * @returns Promise<UploadHistoryResponse> - The user's upload history
  *
  * @example
  * ```typescript
- * const history = await fetchUserDepositHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');
- * console.log('User deposit history:', history.userHistory);
+ * const history = await getUserUploadHistory('9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM');
+ * console.log('User upload history:', history.userHistory);
  * ```
  *
  * @throws {Error} When the user address is invalid or the request fails
  */
-declare function fetchUserDepositHistory(userAddress: string, options?: ServerOptions): Promise<DepositHistoryResponse>;
+declare function getUserUploadHistory(userAddress: string, options?: ServerOptions): Promise<UploadHistoryResponse>;
 
-export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type ServerOptions, type UploadOptions, type UploadResult, type WalletItem, createDepositTxn, fetchUserDepositHistory, getRpcUrl, useDeposit };
+export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type RenewStorageDurationArgs, type ServerOptions, type StorageRenewalCost, type StorageRenewalParams, type StorageRenewalResult, type Transaction, type UploadHistory, type UploadHistoryResponse, type UploadOptions, type UploadParams, type UploadResult, type WalletItem, createDepositTxn, getUserUploadHistory as fetchUserDepositHistory, getUserUploadHistory as fetchUserUploadHistory, getRpcUrl, getStorageRenewalCost, getUserUploadHistory, renewStorageTxn, useUpload as useDeposit, useUpload };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{Connection as C}from"@solana/web3.js";var{NODE_ENV:x}=process.env,l=x==="development"?"http://localhost:5040":"https://storacha-solana-sdk-bshc.onrender.com",P=86400;async function U(r,s={}){if(!r||typeof r!="string")throw new Error("User address is required and must be a string");let n=s.url||l;try{let e=await fetch(`${n}/api/user/user-upload-history?userAddress=${encodeURIComponent(r)}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!e.ok){let a=await e.json().catch(()=>({}));throw new Error(a.message||`Failed to fetch deposit history: ${e.status} ${e.statusText}`)}let i=await e.json();if(typeof i!="object"||i===null)throw new Error("Invalid response format from server");if(typeof i.userAddress!="string")throw new Error("Invalid userAddress in response");return i}catch(e){throw e instanceof Error?e:new Error("Unknown error occurred while fetching deposit history")}}import{PublicKey as S,Transaction as O,TransactionInstruction as R}from"@solana/web3.js";async function k({file:r,duration:s,payer:n,connection:e,signTransaction:i,userEmail:a}){try{let t=new FormData;r.forEach(o=>t.append("file",o)),t.append("duration",s.toString()),t.append("publicKey",n.toBase58()),a&&t.append("userEmail",a);let u=r.length>1,h,E=await fetch(`${l}/api/solana/deposit`,{method:"POST",body:t});if(!E.ok)throw new Error("Failed to get deposit instructions");let c=await E.json();if(!c.instructions||!c.instructions.length)throw new Error("No instructions from deposit API");let w=await e.getLatestBlockhash("confirmed"),g=c.instructions[0],v=new R({programId:new S(g.programId),keys:g.keys.map(o=>({pubkey:new S(o.pubkey),isSigner:o.isSigner,isWritable:o.isWritable})),data:Buffer.from(g.data,"base64")}),m=new O;m.recentBlockhash=w.blockhash,m.feePayer=n,m.add(v);let T=await i(m),y=await e.sendRawTransaction(T.serialize(),{skipPreflight:!1,preflightCommitment:"confirmed"}),D=await e.confirmTransaction({signature:y,blockhash:w.blockhash,lastValidBlockHeight:w.lastValidBlockHeight},"confirmed");if(D.value.err)throw console.error("Failed to confirm this transaction:",D.value.err),new Error(`Transaction failed: ${JSON.stringify(D.value.err)}`);try{await fetch(`${l}/api/user/update-transaction-hash`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:c.cid,transactionHash:y})})}catch(o){console.warn("Failed to update transaction hash:",o)}c.error&&(h=c.error);let b=new FormData;r.forEach(o=>b.append("file",o));let d;if(u?d=await fetch(`${l}/api/user/upload-files?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:b}):d=await fetch(`${l}/api/user/upload-file?cid=${encodeURIComponent(c.cid)}`,{method:"POST",body:b}),!d.ok){let o="Unknown error";try{let I=await d.json();o=I.message||I.error||o}catch{}throw new Error("Deposit API error: "+o)}let p=await d?.json();return{signature:y,success:!0,cid:c.cid,url:p.object.url,message:p.object.message,fileInfo:p.object?{filename:p.object.fileInfo?.filename||"",size:p?.object?.fileInfo?.size||0,uploadedAt:p?.object?.fileInfo?.uploadedAt||"",type:p?.object?.fileInfo?.type||""}:void 0}}catch(t){return console.error(t),t instanceof Error&&(console.error("Error name:",t.name),console.error("Error message:",t.message),console.error("Error stack:",t.stack)),{signature:"",success:!1,cid:"",url:"",message:"",fileInfo:void 0,error:t instanceof Error?t.message:"Unknown error occurred"}}}var j=(e=>(e.mainnet="mainnet-beta",e.testnet="testnet",e.devnet="devnet",e))(j||{});function N(r){switch(r){case"mainnet-beta":return"https://api.mainnet-beta.solana.com";case"testnet":return"https://api.testnet.solana.com";case"devnet":return"https://api.devnet.solana.com";default:throw new Error(`Unsupported environment: ${r}`)}}var f=class{constructor(s){this.estimateStorageCost=(s,n)=>{let a=s.reduce((u,h)=>u+h.size,0)*n*1e3;return{sol:a/1e9,lamports:a}};this.rpcUrl=N(s.environment)}async createDeposit({payer:s,file:n,durationDays:e,signTransaction:i,userEmail:a}){console.log("Creating deposit transaction with environment:",this.rpcUrl);let t=new C(this.rpcUrl,"confirmed");return await k({file:n,duration:e*P,payer:s,connection:t,signTransaction:i,userEmail:a})}async getUserUploadHistory(s){return await U(s)}};var Y=r=>new f({environment:r||"testnet"});export{f as Client,j as Environment,k as createDepositTxn,U as fetchUserDepositHistory,N as getRpcUrl,Y as useDeposit};
+import{Connection as j}from"@solana/web3.js";var l=typeof window<"u"&&window.location.hostname==="localhost"?"http://localhost:5040":"https://storacha-solana-sdk-bshc.onrender.com",P=86400,D=1e9;import{PublicKey as b,SendTransactionError as v,Transaction as I,TransactionInstruction as A}from"@solana/web3.js";async function k({file:o,duration:t,payer:r,connection:e,signTransaction:c,userEmail:s}){try{let n=new FormData;o.forEach(a=>n.append("file",a)),n.append("duration",t.toString()),n.append("publicKey",r.toBase58()),s&&n.append("userEmail",s);let p=o.length>1,h,f=await fetch(`${l}/api/solana/deposit`,{method:"POST",body:n});if(!f.ok)throw new Error("Failed to get deposit instructions");let i=await f.json();if(!i.instructions||!i.instructions.length)throw new Error("No instructions from deposit API");let g=await e.getLatestBlockhash("confirmed"),d=i.instructions[0],m=new A({programId:new b(d.programId),keys:d.keys.map(a=>({pubkey:new b(a.pubkey),isSigner:a.isSigner,isWritable:a.isWritable})),data:Buffer.from(d.data,"base64")}),y=new I;y.recentBlockhash=g.blockhash,y.feePayer=r,y.add(m);let $=await c(y),S;try{S=await e.sendRawTransaction($.serialize(),{skipPreflight:!1,preflightCommitment:"confirmed"})}catch(a){throw a instanceof v?(a.logs??[]).some(N=>N.includes("already in use"))?new Error("This file has already been uploaded. You can find it in your dashboard."):new Error("Transaction failed during simulation. Please try again."):a}let E=await e.confirmTransaction({signature:S,blockhash:g.blockhash,lastValidBlockHeight:g.lastValidBlockHeight},"confirmed");if(E.value.err)throw console.error("Failed to confirm this transaction:",E.value.err),new Error(`Transaction failed: ${JSON.stringify(E.value.err)}`);try{await fetch(`${l}/api/user/update-transaction-hash`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:i.cid,transactionHash:S})})}catch(a){console.warn("Failed to update transaction hash:",a)}i.error&&(h=i.error);let U=new FormData;o.forEach(a=>U.append("file",a));let w;if(p?w=await fetch(`${l}/api/user/upload-files?cid=${encodeURIComponent(i.cid)}`,{method:"POST",body:U}):w=await fetch(`${l}/api/user/upload-file?cid=${encodeURIComponent(i.cid)}`,{method:"POST",body:U}),!w.ok){let a="Unknown error";try{let T=await w.json();a=T.message||T.error||a}catch{}throw new Error("Deposit API error: "+a)}let u=await w?.json();return{signature:S,success:!0,cid:i.cid,url:u.object.url,message:u.object.message,fileInfo:u.object?{filename:u.object.fileInfo?.filename||"",size:u?.object?.fileInfo?.size||0,uploadedAt:u?.object?.fileInfo?.uploadedAt||"",type:u?.object?.fileInfo?.type||""}:void 0}}catch(n){return console.error(n),n instanceof Error&&(console.error("Error name:",n.name),console.error("Error message:",n.message),console.error("Error stack:",n.stack)),{signature:"",success:!1,cid:"",url:"",message:"",fileInfo:void 0,error:n instanceof Error?n.message:"Unknown error occurred"}}}async function C(o,t){try{let r=await fetch(`${l}/api/user/renewal-cost?cid=${encodeURIComponent(o)}&duration=${t}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!r.ok){let e=await r.json();throw new Error(e.message||"Failed to get storage renewal cost")}return await r.json()}catch(r){return console.error("Failed to get storage renewal cost",r),null}}async function x({cid:o,duration:t,payer:r,connection:e,signTransaction:c}){let s=await fetch(`${l}/api/user/renew-storage`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:o,duration:t,publicKey:r.toString()})});if(!s.ok){let d=await s.json().catch(()=>({}));throw new Error(d.message||"Failed to create renewal transaction")}let n=await s.json(),p=new I;n.instructions.forEach(d=>{p.add({programId:new b(d.programId),keys:d.keys.map(m=>({pubkey:new b(m.pubkey),isSigner:m.isSigner,isWritable:m.isWritable})),data:Buffer.from(d.data,"base64")})});let{blockhash:h}=await e.getLatestBlockhash();p.recentBlockhash=h,p.feePayer=r;let f=await c(p),i=await e.sendRawTransaction(f.serialize());return await e.confirmTransaction(i,"confirmed"),(await fetch(`${l}/api/user/confirm-renewal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({cid:o,duration:t,transactionHash:i})})).ok||console.error("Failed to confirm renewal"),{success:!0,cid:o,signature:i,url:`https://w3s.link/ipfs/${o}`,message:"Storage renewed successfully"}}async function O(o,t={}){if(!o||typeof o!="string")throw new Error("User address is required and must be a string");let r=t.url||l;try{let e=await fetch(`${r}/api/user/user-upload-history?userAddress=${encodeURIComponent(o)}`,{method:"GET",headers:{"Content-Type":"application/json"}});if(!e.ok){let s=await e.json().catch(()=>({}));throw new Error(s.message||`Failed to fetch upload history: ${e.status} ${e.statusText}`)}let c=await e.json();if(typeof c!="object"||c===null)throw new Error("Invalid response format from server");if(typeof c.userAddress!="string")throw new Error("Invalid userAddress in response");return c}catch(e){throw e instanceof Error?e:new Error("Unknown error occurred while fetching upload history")}}var F=(e=>(e.mainnet="mainnet-beta",e.testnet="testnet",e.devnet="devnet",e))(F||{});function B(o){switch(o){case"mainnet-beta":return"https://api.mainnet-beta.solana.com";case"testnet":return"https://api.testnet.solana.com";case"devnet":return"https://api.devnet.solana.com";default:throw new Error(`Unsupported environment: ${o}`)}}var R=class{constructor(t){this.rpcUrl=B(t.environment)}async createDeposit({payer:t,file:r,durationDays:e,signTransaction:c,userEmail:s}){console.log("Creating deposit transaction with environment:",this.rpcUrl);let n=new j(this.rpcUrl,"confirmed");return await k({file:r,duration:e*P,payer:t,connection:n,signTransaction:c,userEmail:s})}async estimateStorageCost(t,r){let e=t.reduce((f,i)=>f+i.size,0),c=Math.floor(r/86400),s=await fetch(`${l}/api/user/get-quote?size=${e}&duration=${c}`);if(!s.ok)throw new Error("Failed to get storage cost estimate");let{quote:n}=await s.json(),p=n.totalCost;return{sol:p/D,lamports:p}}async getUserUploadHistory(t){return await O(t)}async getStorageRenewalCost(t,r){return await C(t,r)}async renewStorageDuration({cid:t,duration:r,payer:e,signTransaction:c}){let s=new j(this.rpcUrl,"confirmed");return await x({cid:t,duration:r,payer:e,connection:s,signTransaction:c})}async getSolPrice(){let t=await fetch(`${l}/api/user/sol-price`);if(!t.ok)throw new Error("Couldn't fetch SOL price");return(await t.json()).price}};var ee=o=>new R({environment:o||"testnet"});export{R as Client,F as Environment,k as createDepositTxn,O as fetchUserDepositHistory,O as fetchUserUploadHistory,B as getRpcUrl,C as getStorageRenewalCost,O as getUserUploadHistory,x as renewStorageTxn,ee as useDeposit,ee as useUpload};
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "storacha-sol",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "main": "./dist/index.js",
   "scripts": {
     "build": "tsup src/index.ts --minify",
     "dev": "pnpm build --watch",
-    "pack:local": "pnpm build && pnpm pack"
+    "pack:local": "pnpm build && pnpm pack",
+    "knip": "knip"
   },
   "exports": {
     "import": {
@@ -21,7 +22,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/seetadev/storacha-solana-sdk"
+    "url": "git+https://github.com/seetadev/storacha-solana-sdk.git"
   },
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -43,7 +44,7 @@
     "standard-version": "^9.5.0"
   },
   "devDependencies": {
-    "esbuild": "^0.21.4",
+    "knip": "^5.72.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   }