@toju.network/sol 0.1.0

package/README.md

@@ -0,0 +1,232 @@
+## Storacha SOL
+
+Crypto-native payments for storage on Storacha with SOL. No credit card needed.
+
+Here are a couple of things you can do with this package:
+
+- Estimate upload fees based on the file size and duration
+- Make SOL payments for Storage on Storacha
+- Multiple file (directory) uploads
+- Show how much time is left to expiry
+- 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.
+
+## Usage
+
+First, install the package with your preferred package manager
+
+```shell
+pnpm add storacha-sol
+```
+
+The package exposes a react hook `useDeposit` which you can access the `client` with. Because this runs on Solana for now, you'll need to install any of your preferred solana wallet-adapter libs tailored for React or JS in general
+
+We recommend this one: [@solana/wallet-adpater-react](https://www.npmjs.com/package/@solana/wallet-adapter-react). It'll come in handy when you'll need it to sign the transaction from `client.createDeposit(args)`
+
+In your component, import the `useDeposit` hook like so:
+
+```tsx
+import { useDeposit } from 'storacha-sol';
+
+const UploadComponent = () => {
+  const client = useDeposit('testnet');
+  return <>// some markup</>;
+};
+```
+
+From the snippet above, you'll see that the hook takes an environment argument `"testnet"`. If you leave it as is, Typescript would start crying. So, to appease it, you should import the `Environment` type from `storacha-sol` and infer it.
+
+```ts
+import { useDeposit, Environment } from "storacha-sol"
+...
+
+const client = useDeposit("testnet" as Environment)
+```
+
+In your component, we'll assume you already have file and duration state variables
+
+```tsx
+import { useDeposit, Environment } from 'storacha-sol';
+import { useSolanaWallet } from '@solana/wallet-adapter-react';
+
+const UploadComponent = () => {
+  const [selectedFiles, setSelectedFiles] = useState<File>();
+  const [storageDuration, setStorageDuration] = useState(30);
+  const client = useDeposit('testnet' as Environment);
+  const { publicKey, signTransaction } = useSolanaWallet();
+
+  return <>// some markup</>;
+};
+```
+
+`createDeposit` expects the following args: `payer` (which is the publicKey, imported from wallet-adapter), `file`, `duration`, and the callback to sign a transaction.
+
+See a sample of how you can achieve this below:
+
+```ts
+const result = await client.createDeposit({
+  file,
+  durationDays: storageDuration,
+  payer: publicKey,
+  signTransaction: async (tx) => {
+    toast.loading('Please sign the transaction in your wallet...', {
+      id: 'upload-progress',
+    });
+
+    try {
+      const signed = await signTransaction(tx);
+      toast.loading('Transaction sent to network...', {
+        id: 'upload-progress',
+      });
+
+      return signed;
+    } catch (signError) {
+      console.error('❌ Transaction signing failed:', signError);
+      throw new Error(
+        `Transaction signing failed: ${signError instanceof Error ? signError.message : 'Unknown error'}`
+      );
+    }
+  },
+});
+```
+
+`storacha-sol` is type-safe, so you can always explore the content of the declaration file to see the structure. You could take a look at `UploadResult`, for starters.
+
+and when `result` is successful, you can proceed with any other action you choose to carry out in your app.
+
+```ts
+if (result.success) {
+  // do more stuff
+}
+```
+
+An edge-case you may want to consider before calling `createDeposit` is to check if the estimated storage cost is more than the wallet balance of the user, as this would fail to create the transaction.
+
+You can use `client.estimateStorageCost` to get the values in SOL and compare if the balance is less than what was estimated before paying and provide a reasonable error message for your end-users.
+
+### View Upload History
+
+You can fetch all uploads associated with a wallet address:
+
+```ts
+const client = useDeposit('testnet' as Environment);
+const history = await client.getUserUploadHistory(publicKey.toString());
+
+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`)
+- Transaction hash
+- Duration and cost information
+
+### Email Expiration Warnings
+
+When creating a deposit, you can optionally provide an email address to receive expiration warnings:
+
+```ts
+const result = await client.createDeposit({
+  file,
+  durationDays: storageDuration,
+  payer: publicKey,
+  userEmail: 'user@example.com', // Optional email for expiration warnings
+  signTransaction: async (tx) => {
+    const signed = await signTransaction(tx);
+    return signed;
+  },
+});
+```
+
+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
+- Direct link to view your file on IPFS
+
+### 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

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

@@ -0,0 +1 @@
+{"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  getEndpointForRpc,\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  local = 'localnet',\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    case Environment.local:\n      return 'http://localhost:5040';\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  private apiEndpoint: string;\n\n  constructor(options: ClientOptions) {\n    this.rpcUrl = getRpcUrl(options.environment);\n    this.apiEndpoint = getEndpointForRpc(this.rpcUrl);\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      {\n        file,\n        duration: durationDays * DAY_TIME_IN_SECONDS,\n        payer,\n        connection,\n        signTransaction,\n        userEmail,\n      },\n      this.apiEndpoint\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      `${this.apiEndpoint}/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, page: number, limit: number) {\n    const response = await getUserUploadHistory(userAddress, this.apiEndpoint, {\n      page,\n      limit,\n    });\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, this.apiEndpoint);\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      {\n        cid,\n        duration,\n        payer,\n        connection,\n        signTransaction,\n      },\n      this.apiEndpoint\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<number> {\n    const request = await fetch(`${this.apiEndpoint}/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","const ENDPOINTS = {\n  local: 'http://localhost:5040',\n  staging: 'https://staging-api.toju.network',\n  production: 'https://api.toju.network',\n} as const;\n\n/**\n * Determines the appropriate backend endpoint based on Solana RPC URL\n */\nexport function getEndpointForRpc(rpcUrl: string): string {\n  if (typeof window !== 'undefined') {\n    const hostname = window.location.hostname;\n    if (hostname === 'localhost' || hostname === '127.0.0.1')\n      return ENDPOINTS.local;\n  }\n\n  const url = rpcUrl.toLowerCase();\n\n  if (url.includes('localhost') || url.includes('127.0.0.1')) {\n    return ENDPOINTS.local;\n  }\n\n  if (url.includes('mainnet')) {\n    return ENDPOINTS.production;\n  }\n\n  if (url.includes('testnet') || url.includes('devnet')) {\n    return ENDPOINTS.staging;\n  }\n\n  return ENDPOINTS.production;\n}\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 {\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  args: CreateDepositArgs,\n  apiEndpoint: string\n): Promise<UploadResult> {\n  const { file, duration, payer, connection, signTransaction, userEmail } =\n    args;\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(`${apiEndpoint}/upload/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(`${apiEndpoint}/upload/confirm`, {\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        `${apiEndpoint}/upload/files?cid=${encodeURIComponent(depositRes.cid)}`,\n        {\n          method: 'POST',\n          body: uploadForm,\n        }\n      );\n    } else {\n      fileUploadReq = await fetch(\n        `${apiEndpoint}/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\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  apiEndpoint: string\n): Promise<StorageRenewalCost | null> {\n  try {\n    const request = await fetch(\n      `${apiEndpoint}/storage/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  args: RenewStorageDurationArgs,\n  apiEndpoint: string\n): Promise<UploadResult> {\n  const { cid, duration, payer, connection, signTransaction } = args;\n  const renewalTransactionIx = await fetch(`${apiEndpoint}/storage/renew`, {\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  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(\n    `${apiEndpoint}/storage/confirm-renewal`,\n    {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        cid,\n        duration,\n        transactionHash: signature,\n      }),\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 { 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\n * @param apiEndpoint - Base API URL\n * @param options - Optional server configuration and pagination options\n * @returns Promise<UploadHistoryResponse>\n *\n * @example\n * ```ts\n * const history = await getUserUploadHistory(\n *   '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',\n *   API_BASE_URL,\n *   { page: 1, limit: 20 }\n * )\n *\n * console.log(history.data)\n * console.log(history.next)\n * ```\n *\n * @throws {Error} When the user address is invalid or the request fails\n */\nexport async function getUserUploadHistory(\n  userAddress: string,\n  apiEndpoint: string,\n  options: ServerOptions & {\n    page?: number;\n    limit?: number;\n  } = {}\n): Promise<UploadHistoryResponse> {\n  if (!userAddress || typeof userAddress !== 'string') {\n    throw new Error('User address is required and must be a string');\n  }\n\n  const baseUrl = options.url || apiEndpoint;\n  const page = options.page ?? 1;\n  const limit = options.limit ?? 20;\n\n  try {\n    const response = await fetch(\n      `${baseUrl}/upload/history?userAddress=${encodeURIComponent(userAddress)}?userAddress=${encodeURIComponent(userAddress)}&page=${page}&limit=${limit}`,\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    if (\n      typeof data !== 'object' ||\n      data === null ||\n      !Array.isArray(data.data) ||\n      typeof data !== 'object'\n    ) {\n      throw new Error('Invalid response format from server');\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, Environment } from './client';\n\nexport const useUpload = (environment: 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","ENDPOINTS","getEndpointForRpc","rpcUrl","hostname","url","DAY_TIME_IN_SECONDS","ONE_BILLION_LAMPORTS","import_web3","createDepositTxn","args","apiEndpoint","file","duration","payer","connection","signTransaction","userEmail","formData","f","isMultipleFiles","uploadErr","depositReq","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","apiEndpoint","options","baseUrl","page","limit","response","errorData","data","error","Environment","getRpcUrl","env","Client","options","getEndpointForRpc","payer","file","durationDays","signTransaction","userEmail","connection","createDepositTxn","DAY_TIME_IN_SECONDS","duration","fileSizeInBytes","acc","f","durationInDays","response","quote","totalLamports","ONE_BILLION_LAMPORTS","userAddress","page","limit","getUserUploadHistory","cid","getStorageRenewalCost","renewStorageTxn","request","useUpload","environment","Client"]}

package/dist/index.d.cts

@@ -0,0 +1,467 @@
+import { Address, Signature } from '@solana/kit';
+import { PublicKey, Connection, Transaction as Transaction$1 } from '@solana/web3.js';
+
+interface ServerOptions {
+    /** URL pointing to the server (mostly Storacha's) */
+    url?: string;
+}
+/**
+ * Options needed to create an on-chain deposit for storage
+ */
+interface UploadOptions {
+    /** content identifier for the data to be uploaded */
+    cid: string;
+    /** file/upload size in bytes */
+    size: number;
+    /** duration in days for how long the data should be retained */
+    duration: number;
+    /** wallet responsible for paying the deposit */
+    payer: Address;
+    /** optional Solana connection override (for testing or custom RPC) */
+    connection?: any;
+    /** Signature or transaction hash as proof of on-chain deposit */
+    signature?: string;
+}
+/**
+ * Result returned after a successful file upload
+ */
+interface UploadResult {
+    /** message from the deposit transaction. could be an error or success message */
+    message?: string;
+    /** similar to message above  but for error cases. can extrapoloate this later */
+    error?: string;
+    /** signature of the succesful transaction */
+    signature: Signature;
+    /** status of the request. successful or not. */
+    success: boolean;
+    /** CID of the uploaded content */
+    cid: string;
+    /** full URL where the content was uploaded to (on IPFS) */
+    url: string;
+    /** information of the file that was uploaded */
+    fileInfo?: {
+        /** file type */
+        type: string;
+        /** size of the uploaded content (in bytes) */
+        size: number;
+        /** UNIX timestamp (in seconds) of the time the file was uploaded */
+        uploadedAt: string;
+        /** name of the file uploaded */
+        filename: string;
+    };
+}
+/**
+ * Stored item entry returned when listing wallet space
+ */
+interface WalletItem {
+    /** CID of the stored item */
+    cid: string;
+    /** file size in bytes */
+    size: number;
+    /** expiration timestamp in seconds */
+    expiresAt: number;
+}
+/**
+ * Config values fetched from the on-chain ConfigAccount
+ */
+interface OnChainConfig {
+    /** current rate in lamports per byte per day */
+    ratePerBytePerDay: bigint;
+    /** minimum required duration in days */
+    minDurationDays: number;
+    /** wallet where provider can withdraw claimed funds */
+    withdrawalWallet: Address;
+}
+/**
+ * Deposit details stored on-chain for each user upload
+ */
+interface OnChainDeposit {
+    /** public key of the depositor */
+    depositor: Address;
+    /** file object containing metadata about the upload */
+    file: File[];
+    /** storage duration (days) */
+    duration: number;
+    /** amount deposited in lamports */
+    depositAmount: bigint;
+    /** slot when deposit was made */
+    depositSlot: number;
+    /** last claimed slot for reward release */
+    lastClaimedSlot: number;
+}
+interface DepositResult extends Pick<UploadResult, 'message' | 'error'> {
+    /** CID of the stored item */
+    cid: string;
+    /** transaction instruction */
+    instructions: Array<{
+        programId: string;
+        keys: Array<{
+            pubkey: string;
+            isSigner: boolean;
+            isWritable: boolean;
+        }>;
+        data: string;
+    }>;
+    /** result of a successful upload */
+    object: UploadResult;
+}
+interface CreateDepositArgs extends Omit<OnChainDeposit, 'depositAmount' | 'depositor' | 'depositSlot' | 'lastClaimedSlot'> {
+    /** Public key of the user paying for the upload */
+    payer: PublicKey;
+    /** Wallet connection used to query chain state or recent blockhash */
+    connection: Connection;
+    /**
+     * a callback function to authorize the transaction via the solana wallet lib
+     * @example
+     * const {publickKey, signTransaction} = useSolanaWallet()
+     * const signTransaction = await signTransaction(tx)
+     * */
+    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 upload history entry from the server
+ */
+interface UploadHistory {
+    /** Unique identifier for the deposit */
+    id: number;
+    /** User's wallet address (deposit key) */
+    depositKey: string;
+    /** Content identifier of the uploaded file */
+    contentCid: string;
+    /** Duration in days the file is stored for */
+    durationDays: number;
+    /** Amount deposited in lamports */
+    depositAmount: number;
+    /** Slot when the deposit was made */
+    depositSlot: number;
+    /** Last slot when rewards were claimed */
+    lastClaimedSlot: number;
+    /** Timestamp when the deposit was created */
+    createdAt: string;
+    /** Expiration date of the upload */
+    expiresAt?: string;
+    /** User email for notifications */
+    userEmail?: string;
+    /** Name of the uploaded file */
+    fileName?: string;
+    /** MIME type of the file */
+    fileType?: string;
+    /** Size of the file in bytes */
+    fileSize?: number;
+    /** Solana transaction hash */
+    transactionHash?: string;
+    /** Deletion status: 'active' | 'warned' | 'deleted' */
+    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;
+interface PaginationMeta {
+    /** Total number of records */
+    total: number;
+    /** Current page (1-indexed) */
+    page: number;
+    /** Page size */
+    pageSize: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** URL to fetch next page */
+    next: string | null;
+    /** URL to fetch previous page */
+    prev: string | null;
+}
+/**
+ * Response from the getUserUploadHistory endpoint
+ */
+interface UploadHistoryResponse extends PaginationMeta {
+    /** Array of upload history entries */
+    data: 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",
+    testnet = "testnet",
+    devnet = "devnet",
+    local = "localnet"
+}
+declare function getRpcUrl(env: Environment): string;
+interface ClientOptions {
+    /** Solana RPC endpoint to use for chain interactions */
+    environment: Environment;
+}
+interface UploadParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
+    /** Wallet public key of the payer */
+    payer: PublicKey;
+    /** File(s) to be stored */
+    file: File[];
+    /** Duration in days to store the data */
+    durationDays: number;
+}
+/**
+ * @deprecated Use {@link UploadParams} instead.
+ */
+type DepositParams = UploadParams;
+/**
+ * Solana Storage Client — simplified (no fee estimation)
+ */
+declare class Client {
+    private rpcUrl;
+    private apiEndpoint;
+    constructor(options: ClientOptions);
+    /**
+     * Creates a deposit transaction ready to be signed & sent by user's wallet.
+     *
+     * @param {Object} params
+     * @param {PublicKey} params.payer - The public key (wallet address) of the connected wallet.
+     * @param {File} params.file - The file to be uploaded.
+     * @param {number} params.durationDays - How long (in days) the file should be stored.
+     * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction -
+     *   A callback function to authorize the transaction via the Solana wallet library.
+     *
+     * @example
+     * const { publicKey, signTransaction } = useSolanaWallet();
+     * const result = await createDeposit({
+     *   payer: publicKey,
+     *   file,
+     *   durationDays: 30,
+     *   signTransaction,
+     * });
+     *
+     * @returns {Promise<UploadResult>} The upload result after transaction is processed.
+     */
+    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): Promise<{
+        sol: number;
+        lamports: any;
+    }>;
+    getUserUploadHistory(userAddress: string, page: number, limit: number): 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<number>;
+}
+
+declare const useUpload: (environment: Environment) => Client;
+
+/**
+ * Calls the deposit API for on-chain storage and returns a Transaction
+ * which must be signed and sent externally by the user.
+ *
+ * @param params - {
+ *   cid: string;
+ *   file: File;
+ *   duration: number;
+ *   payer: PublicKey;
+ *   connection: Connection;
+ * }
+ * @returns Transaction
+ */
+declare function createDepositTxn(args: CreateDepositArgs, apiEndpoint: string): Promise<UploadResult>;
+/**
+ * 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, apiEndpoint: string): 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(args: RenewStorageDurationArgs, apiEndpoint: string): Promise<UploadResult>;
+
+/**
+ * Get the upload history for a given user address from the server
+ *
+ * @param userAddress - The wallet address of the user
+ * @param apiEndpoint - Base API URL
+ * @param options - Optional server configuration and pagination options
+ * @returns Promise<UploadHistoryResponse>
+ *
+ * @example
+ * ```ts
+ * const history = await getUserUploadHistory(
+ *   '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
+ *   API_BASE_URL,
+ *   { page: 1, limit: 20 }
+ * )
+ *
+ * console.log(history.data)
+ * console.log(history.next)
+ * ```
+ *
+ * @throws {Error} When the user address is invalid or the request fails
+ */
+declare function getUserUploadHistory(userAddress: string, apiEndpoint: string, options?: ServerOptions & {
+    page?: number;
+    limit?: number;
+}): Promise<UploadHistoryResponse>;
+
+export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type PaginationMeta, 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

@@ -0,0 +1,467 @@
+import { Address, Signature } from '@solana/kit';
+import { PublicKey, Connection, Transaction as Transaction$1 } from '@solana/web3.js';
+
+interface ServerOptions {
+    /** URL pointing to the server (mostly Storacha's) */
+    url?: string;
+}
+/**
+ * Options needed to create an on-chain deposit for storage
+ */
+interface UploadOptions {
+    /** content identifier for the data to be uploaded */
+    cid: string;
+    /** file/upload size in bytes */
+    size: number;
+    /** duration in days for how long the data should be retained */
+    duration: number;
+    /** wallet responsible for paying the deposit */
+    payer: Address;
+    /** optional Solana connection override (for testing or custom RPC) */
+    connection?: any;
+    /** Signature or transaction hash as proof of on-chain deposit */
+    signature?: string;
+}
+/**
+ * Result returned after a successful file upload
+ */
+interface UploadResult {
+    /** message from the deposit transaction. could be an error or success message */
+    message?: string;
+    /** similar to message above  but for error cases. can extrapoloate this later */
+    error?: string;
+    /** signature of the succesful transaction */
+    signature: Signature;
+    /** status of the request. successful or not. */
+    success: boolean;
+    /** CID of the uploaded content */
+    cid: string;
+    /** full URL where the content was uploaded to (on IPFS) */
+    url: string;
+    /** information of the file that was uploaded */
+    fileInfo?: {
+        /** file type */
+        type: string;
+        /** size of the uploaded content (in bytes) */
+        size: number;
+        /** UNIX timestamp (in seconds) of the time the file was uploaded */
+        uploadedAt: string;
+        /** name of the file uploaded */
+        filename: string;
+    };
+}
+/**
+ * Stored item entry returned when listing wallet space
+ */
+interface WalletItem {
+    /** CID of the stored item */
+    cid: string;
+    /** file size in bytes */
+    size: number;
+    /** expiration timestamp in seconds */
+    expiresAt: number;
+}
+/**
+ * Config values fetched from the on-chain ConfigAccount
+ */
+interface OnChainConfig {
+    /** current rate in lamports per byte per day */
+    ratePerBytePerDay: bigint;
+    /** minimum required duration in days */
+    minDurationDays: number;
+    /** wallet where provider can withdraw claimed funds */
+    withdrawalWallet: Address;
+}
+/**
+ * Deposit details stored on-chain for each user upload
+ */
+interface OnChainDeposit {
+    /** public key of the depositor */
+    depositor: Address;
+    /** file object containing metadata about the upload */
+    file: File[];
+    /** storage duration (days) */
+    duration: number;
+    /** amount deposited in lamports */
+    depositAmount: bigint;
+    /** slot when deposit was made */
+    depositSlot: number;
+    /** last claimed slot for reward release */
+    lastClaimedSlot: number;
+}
+interface DepositResult extends Pick<UploadResult, 'message' | 'error'> {
+    /** CID of the stored item */
+    cid: string;
+    /** transaction instruction */
+    instructions: Array<{
+        programId: string;
+        keys: Array<{
+            pubkey: string;
+            isSigner: boolean;
+            isWritable: boolean;
+        }>;
+        data: string;
+    }>;
+    /** result of a successful upload */
+    object: UploadResult;
+}
+interface CreateDepositArgs extends Omit<OnChainDeposit, 'depositAmount' | 'depositor' | 'depositSlot' | 'lastClaimedSlot'> {
+    /** Public key of the user paying for the upload */
+    payer: PublicKey;
+    /** Wallet connection used to query chain state or recent blockhash */
+    connection: Connection;
+    /**
+     * a callback function to authorize the transaction via the solana wallet lib
+     * @example
+     * const {publickKey, signTransaction} = useSolanaWallet()
+     * const signTransaction = await signTransaction(tx)
+     * */
+    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 upload history entry from the server
+ */
+interface UploadHistory {
+    /** Unique identifier for the deposit */
+    id: number;
+    /** User's wallet address (deposit key) */
+    depositKey: string;
+    /** Content identifier of the uploaded file */
+    contentCid: string;
+    /** Duration in days the file is stored for */
+    durationDays: number;
+    /** Amount deposited in lamports */
+    depositAmount: number;
+    /** Slot when the deposit was made */
+    depositSlot: number;
+    /** Last slot when rewards were claimed */
+    lastClaimedSlot: number;
+    /** Timestamp when the deposit was created */
+    createdAt: string;
+    /** Expiration date of the upload */
+    expiresAt?: string;
+    /** User email for notifications */
+    userEmail?: string;
+    /** Name of the uploaded file */
+    fileName?: string;
+    /** MIME type of the file */
+    fileType?: string;
+    /** Size of the file in bytes */
+    fileSize?: number;
+    /** Solana transaction hash */
+    transactionHash?: string;
+    /** Deletion status: 'active' | 'warned' | 'deleted' */
+    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;
+interface PaginationMeta {
+    /** Total number of records */
+    total: number;
+    /** Current page (1-indexed) */
+    page: number;
+    /** Page size */
+    pageSize: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** URL to fetch next page */
+    next: string | null;
+    /** URL to fetch previous page */
+    prev: string | null;
+}
+/**
+ * Response from the getUserUploadHistory endpoint
+ */
+interface UploadHistoryResponse extends PaginationMeta {
+    /** Array of upload history entries */
+    data: 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",
+    testnet = "testnet",
+    devnet = "devnet",
+    local = "localnet"
+}
+declare function getRpcUrl(env: Environment): string;
+interface ClientOptions {
+    /** Solana RPC endpoint to use for chain interactions */
+    environment: Environment;
+}
+interface UploadParams extends Pick<CreateDepositArgs, 'signTransaction' | 'userEmail'> {
+    /** Wallet public key of the payer */
+    payer: PublicKey;
+    /** File(s) to be stored */
+    file: File[];
+    /** Duration in days to store the data */
+    durationDays: number;
+}
+/**
+ * @deprecated Use {@link UploadParams} instead.
+ */
+type DepositParams = UploadParams;
+/**
+ * Solana Storage Client — simplified (no fee estimation)
+ */
+declare class Client {
+    private rpcUrl;
+    private apiEndpoint;
+    constructor(options: ClientOptions);
+    /**
+     * Creates a deposit transaction ready to be signed & sent by user's wallet.
+     *
+     * @param {Object} params
+     * @param {PublicKey} params.payer - The public key (wallet address) of the connected wallet.
+     * @param {File} params.file - The file to be uploaded.
+     * @param {number} params.durationDays - How long (in days) the file should be stored.
+     * @param {(tx: Transaction) => Promise<Transaction>} params.signTransaction -
+     *   A callback function to authorize the transaction via the Solana wallet library.
+     *
+     * @example
+     * const { publicKey, signTransaction } = useSolanaWallet();
+     * const result = await createDeposit({
+     *   payer: publicKey,
+     *   file,
+     *   durationDays: 30,
+     *   signTransaction,
+     * });
+     *
+     * @returns {Promise<UploadResult>} The upload result after transaction is processed.
+     */
+    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): Promise<{
+        sol: number;
+        lamports: any;
+    }>;
+    getUserUploadHistory(userAddress: string, page: number, limit: number): 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<number>;
+}
+
+declare const useUpload: (environment: Environment) => Client;
+
+/**
+ * Calls the deposit API for on-chain storage and returns a Transaction
+ * which must be signed and sent externally by the user.
+ *
+ * @param params - {
+ *   cid: string;
+ *   file: File;
+ *   duration: number;
+ *   payer: PublicKey;
+ *   connection: Connection;
+ * }
+ * @returns Transaction
+ */
+declare function createDepositTxn(args: CreateDepositArgs, apiEndpoint: string): Promise<UploadResult>;
+/**
+ * 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, apiEndpoint: string): 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(args: RenewStorageDurationArgs, apiEndpoint: string): Promise<UploadResult>;
+
+/**
+ * Get the upload history for a given user address from the server
+ *
+ * @param userAddress - The wallet address of the user
+ * @param apiEndpoint - Base API URL
+ * @param options - Optional server configuration and pagination options
+ * @returns Promise<UploadHistoryResponse>
+ *
+ * @example
+ * ```ts
+ * const history = await getUserUploadHistory(
+ *   '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
+ *   API_BASE_URL,
+ *   { page: 1, limit: 20 }
+ * )
+ *
+ * console.log(history.data)
+ * console.log(history.next)
+ * ```
+ *
+ * @throws {Error} When the user address is invalid or the request fails
+ */
+declare function getUserUploadHistory(userAddress: string, apiEndpoint: string, options?: ServerOptions & {
+    page?: number;
+    limit?: number;
+}): Promise<UploadHistoryResponse>;
+
+export { Client, type ClientOptions, type CreateDepositArgs, type DepositHistoryEntry, type DepositHistoryResponse, type DepositParams, type DepositResult, Environment, type OnChainConfig, type OnChainDeposit, type PaginationMeta, 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

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@toju.network/sol",
+  "version": "0.1.0",
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.js.map"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --minify",
+    "dev": "pnpm build --watch",
+    "pack:local": "pnpm build && pnpm pack",
+    "knip": "knip"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seetadev/storacha-solana-sdk.git"
+  },
+  "keywords": [
+    "solana",
+    "storacha",
+    "typescript",
+    "web3",
+    "ipfs",
+    "filecoin",
+    "decentralized-storage",
+    "blockchain"
+  ],
+  "author": "toju.network",
+  "license": "ISC",
+  "description": "Decentralized storage SDK for Solana via Storacha - pay with SOL, store on IPFS",
+  "packageManager": "pnpm@10.11.0",
+  "dependencies": {
+    "@solana/kit": "^2.3.0",
+    "@solana/web3.js": "^1.98.2",
+    "standard-version": "^9.5.0"
+  },
+  "devDependencies": {
+    "knip": "^5.72.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  }
+}