{"uid":"cap_4NHcMNm4JtVhQqgMNuMAJ","slug":"ipfs-pinning-provider-procurement-decision-procedure-f8227b3f","name":"IPFS Pinning Provider Procurement Decision Procedure","description":"Deterministic decision procedure for an agent that must persist a file or dataset to IPFS/Filecoin. Inputs: object size, retention window, budget, provider candidates. Outputs: pin / do-not-pin / needs-review with evidence. Checks: provider selection across Pinata, web3.storage, Filebase, and Lighthouse by price per GB and durability; per-object and monthly spend caps; redundancy threshold for important artifacts (pin to 2+ providers); CID retrieval proof via real GET before any settlement;","url":"https://k2so-8080.on.ascii.dev/api/services/agent-facing-ipfs-filecoin-storage-procurement-d","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"IPFS pinning provider procurement decision procedure paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NMYftYkDbUTF1qx8kHfx7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a deterministic decision (pin / do-not-pin / needs-review) for persisting a file or dataset to IPFS/Filecoin, with provider selection across Pinata, web3.storage, Filebase, and Lighthouse based on price, durability, and redundancy.","exampleAgentPrompt":"I need to pin a 25 GB dataset to IPFS for 2 years with a monthly budget of $5 — can you run the procurement decision procedure and tell me whether to pin it, which providers to use across Pinata, web3.storage, Filebase, and Lighthouse, and whether I need redundancy across at least 2 providers?","exampleUseCases":[{"title":"Budget-constrained dataset pinning decision","prompt":"I have a 50 GB ML training dataset I want to store on IPFS for 18 months, but my total budget is $20. Run the IPFS pinning decision procedure and tell me if I should pin it, which provider wins on price and durability, and whether my budget allows for redundant pinning across two providers."},{"title":"Important build artifact redundancy check","prompt":"My CI pipeline just produced a critical release artifact — about 2 GB — that needs to survive for at least 3 years. Can you run the IPFS procurement decision on it, check whether Pinata and Filebase can both pin it under a $3 per-object cap, and confirm the CID is retrievable before we commit?"},{"title":"Monthly spend cap enforcement for agent storage","prompt":"My agent needs to decide whether to pin a new 500 MB file to IPFS this month, but I've already spent $8 of my $10 monthly storage budget. Run the pinning decision procedure and tell me if this object fits within my remaining cap, and which single provider gives the best durability for what's left."}],"resultDescription":"A structured decision object containing: an ok/not-ok outcome flag, a pin/do-not-pin/needs-review verdict, prose explanation of the decision rationale, selected provider(s) with price-per-GB evidence, redundancy assessment, CID retrieval proof status, budget utilization breakdown, generation timestamp, and the generation source (llm, reasoning, or deterministic).","failureModes":["Provider candidates unavailable or pricing data stale — returns needs-review with explanation","Budget cap already exceeded before evaluation — returns do-not-pin with spend detail","CID retrieval proof fails GET check — blocks settlement and returns needs-review","Payment not completed (402) — returns unpaid metadata only if meta=1 query param set","Invalid or missing required input fields — returns error with schema validation message","Monthly spend cap breach detected mid-evaluation — returns do-not-pin with cap evidence"],"whenToPreferThis":"Use this endpoint when an agent needs a structured, auditable go/no-go decision on IPFS/Filecoin storage before committing spend — especially when comparing multiple providers (Pinata, web3.storage, Filebase, Lighthouse) on price and durability, enforcing per-object or monthly budget caps, requiring redundant pinning for important artifacts, or needing CID retrieval proof before any settlement. Prefer this over manual provider lookups or generic storage APIs when you need a single deterministic recommendation with evidence rather than raw pricing data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:01:40.106Z","isFirstParty":false}