/**
 * IPFS pinning, direct uploads, IPNS names and customer gateway domains
 * (which can serve your pins directly at /ipfs/<cid>). Prepaid hourly
 * billing per pinned MiB plus gateway egress; deletes are always free. The
 * standard IPFS Pinning Service API lives in `pins`.
 *
 * For uploading local content use `addFile`, which drives the whole
 * grant → upload → pin flow.
 */
import type { Client } from './client.js';
import * as http from './http.js';
import type { Body, Query, Res } from './types.js';
/** GET /ipfs/pins — List your pins (offset-paginated). */
export declare const listPins: (client: Client, query?: Query<"/ipfs/pins", "get">) => Promise<{
    pins: {
        cid: string | null;
        cid_v1: string | null;
        created_at: string | null;
        gateway_url: string | null;
        id: string;
        last_error: string | null;
        meta: {
            [key: string]: string;
        };
        name: string | null;
        size_bytes: number | null;
        state: "awaiting-upload" | "queued" | "pinning" | "pinned" | "failed" | "deleting";
        updated_at: string | null;
    }[];
    total: number;
}>;
/** Every pin, following offset pagination (page `limit` defaults to 100). */
export declare const listAllPins: (client: Client, query?: Query<"/ipfs/pins", "get">) => Promise<readonly {
    cid: string | null;
    cid_v1: string | null;
    created_at: string | null;
    gateway_url: string | null;
    id: string;
    last_error: string | null;
    meta: {
        [key: string]: string;
    };
    name: string | null;
    size_bytes: number | null;
    state: "awaiting-upload" | "queued" | "pinning" | "pinned" | "failed" | "deleting";
    updated_at: string | null;
}[]>;
/** POST /ipfs/pins — Pin by CID (202; billing starts once pinned). */
export declare const pin: (client: Client, body: Body<"/ipfs/pins", "post">) => Promise<{
    pin: {
        cid: string | null;
        cid_v1: string | null;
        created_at: string | null;
        gateway_url: string | null;
        id: string;
        last_error: string | null;
        meta: {
            [key: string]: string;
        };
        name: string | null;
        size_bytes: number | null;
        state: "awaiting-upload" | "queued" | "pinning" | "pinned" | "failed" | "deleting";
        updated_at: string | null;
    };
}>;
/** GET /ipfs/pins/{id} — Pin detail. */
export declare const getPin: (client: Client, id: string) => Promise<{
    pin: {
        cid: string | null;
        cid_v1: string | null;
        created_at: string | null;
        gateway_url: string | null;
        id: string;
        last_error: string | null;
        meta: {
            [key: string]: string;
        };
        name: string | null;
        size_bytes: number | null;
        state: "awaiting-upload" | "queued" | "pinning" | "pinned" | "failed" | "deleting";
        updated_at: string | null;
    };
}>;
/** DELETE /ipfs/pins/{id} — Unpin (202; free). */
export declare const unpin: (client: Client, id: string) => Promise<{
    deleted: boolean;
}>;
/**
 * POST /ipfs/uploads — Start a direct upload. Issues a short-lived
 * single-use grant `{ upload: { url, token, ... } }`; POST the raw bytes to
 * that URL (see `http.uploadBytes`) then poll `getUpload`.
 */
export declare const startUpload: (client: Client, body?: Body<"/ipfs/uploads", "post">) => Promise<{
    upload: {
        cid: string | null;
        error: string | null;
        expires_at: string | null;
        id: string;
        max_bytes: number;
        pin_id: string;
        size_bytes: number | null;
        status: "issued" | "completed" | "failed" | "expired";
        token: string | null;
        url: string;
    };
}>;
/** GET /ipfs/uploads/{id} — Upload status (issued/completed/failed/expired). */
export declare const getUpload: (client: Client, id: string) => Promise<{
    upload: {
        cid: string | null;
        error: string | null;
        expires_at: string | null;
        id: string;
        max_bytes: number;
        pin_id: string;
        size_bytes: number | null;
        status: "issued" | "completed" | "failed" | "expired";
        token: string | null;
        url: string;
    };
}>;
/** GET /ipfs/names — List your IPNS names. */
export declare const listNames: (client: Client) => Promise<{
    names: {
        created_at: string | null;
        id: string;
        label: string;
        last_error: string | null;
        last_published_at: string | null;
        last_published_cid: string | null;
        name: string | null;
        state: "creating" | "active" | "failed" | "deleting";
        target_cid: string | null;
        target_url: string | null;
        updated_at: string | null;
        url: string | null;
    }[];
}>;
/** POST /ipfs/names — Create an IPNS name. */
export declare const createName: (client: Client, body?: Body<"/ipfs/names", "post">) => Promise<{
    domain?: {
        created_at: string | null;
        delegated?: boolean;
        dns_target?: string;
        dnslink_hint: string;
        domain: string;
        id: string;
        ipns_name_id: string | null;
        last_error: string | null;
        pin_count: number;
        state: "pending" | "active" | "failed" | "deleting";
        updated_at: string | null;
        verified_at: string | null;
    };
    name: {
        created_at: string | null;
        id: string;
        label: string;
        last_error: string | null;
        last_published_at: string | null;
        last_published_cid: string | null;
        name: string | null;
        state: "creating" | "active" | "failed" | "deleting";
        target_cid: string | null;
        target_url: string | null;
        updated_at: string | null;
        url: string | null;
    };
}>;
/** GET /ipfs/names/{id} — IPNS name detail. */
export declare const getName: (client: Client, id: string) => Promise<{
    name: {
        created_at: string | null;
        id: string;
        label: string;
        last_error: string | null;
        last_published_at: string | null;
        last_published_cid: string | null;
        name: string | null;
        state: "creating" | "active" | "failed" | "deleting";
        target_cid: string | null;
        target_url: string | null;
        updated_at: string | null;
        url: string | null;
    };
}>;
/** DELETE /ipfs/names/{id} — Delete an IPNS name (202). */
export declare const deleteName: (client: Client, id: string) => Promise<{
    deleted: boolean;
}>;
/** PUT /ipfs/names/{id}/target — Publish a new target for an IPNS name. */
export declare const publishTarget: (client: Client, id: string, body: Body<"/ipfs/names/{id}/target", "put">) => Promise<{
    name: {
        created_at: string | null;
        id: string;
        label: string;
        last_error: string | null;
        last_published_at: string | null;
        last_published_cid: string | null;
        name: string | null;
        state: "creating" | "active" | "failed" | "deleting";
        target_cid: string | null;
        target_url: string | null;
        updated_at: string | null;
        url: string | null;
    };
}>;
/** GET /ipfs/domains — List your gateway domains. */
export declare const listDomains: (client: Client) => Promise<{
    domains: {
        created_at: string | null;
        delegated?: boolean;
        dns_target?: string;
        dnslink_hint: string;
        domain: string;
        id: string;
        ipns_name_id: string | null;
        last_error: string | null;
        pin_count: number;
        state: "pending" | "active" | "failed" | "deleting";
        updated_at: string | null;
        verified_at: string | null;
    }[];
}>;
/**
 * POST /ipfs/domains — Attach your own domain as an IPFS gateway. Gated on
 * `domain`. The response's `dns_target` is the gateway IPv4 the domain's A
 * record must point at on manually mapped rows.
 */
export declare const attachDomain: (client: Client, body: Body<"/ipfs/domains", "post">) => Promise<{
    domain: {
        created_at: string | null;
        delegated?: boolean;
        dns_target?: string;
        dnslink_hint: string;
        domain: string;
        id: string;
        ipns_name_id: string | null;
        last_error: string | null;
        pin_count: number;
        state: "pending" | "active" | "failed" | "deleting";
        updated_at: string | null;
        verified_at: string | null;
    };
}>;
/** GET /ipfs/domains/{id} — Gateway domain detail. */
export declare const getDomain: (client: Client, id: string) => Promise<{
    domain: {
        created_at: string | null;
        delegated?: boolean;
        dns_target?: string;
        dnslink_hint: string;
        domain: string;
        id: string;
        ipns_name_id: string | null;
        last_error: string | null;
        pin_count: number;
        state: "pending" | "active" | "failed" | "deleting";
        updated_at: string | null;
        verified_at: string | null;
    };
}>;
/** GET /ipfs/domains/{id}/pins — The pins a gateway domain serves, oldest attachment first. */
export declare const listDomainPins: (client: Client, id: string, query?: Query<"/ipfs/domains/{id}/pins", "get">) => Promise<{
    limit: number;
    offset: number;
    pins: {
        attached_at: string | null;
        cid: string | null;
        cid_v1: string | null;
        id: string;
        name: string | null;
        state: string;
    }[];
    total: number;
}>;
/** Every pin a gateway domain serves, following offset pagination. */
export declare const listAllDomainPins: (client: Client, id: string, query?: Query<"/ipfs/domains/{id}/pins", "get">) => Promise<readonly {
    attached_at: string | null;
    cid: string | null;
    cid_v1: string | null;
    id: string;
    name: string | null;
    state: string;
}[]>;
/**
 * POST /ipfs/domains/{id}/pins — Attach or detach the pins a gateway
 * domain serves (`add` / `remove` pin ids; idempotent delta). Gated on the
 * gateway's domain (resolved via `getDomain` when a gate is set).
 */
export declare const updateDomainPins: (client: Client, id: string, body: Body<"/ipfs/domains/{id}/pins", "post">) => Promise<{
    domain: {
        created_at: string | null;
        delegated?: boolean;
        dns_target?: string;
        dnslink_hint: string;
        domain: string;
        id: string;
        ipns_name_id: string | null;
        last_error: string | null;
        pin_count: number;
        state: "pending" | "active" | "failed" | "deleting";
        updated_at: string | null;
        verified_at: string | null;
    };
}>;
/** DELETE /ipfs/domains/{id} — Detach a gateway domain (202). Gated on the gateway's domain. */
export declare const detachDomain: (client: Client, id: string) => Promise<{
    deleted: boolean;
}>;
/** GET /ipfs/usage — Storage usage and cost. */
export declare const usage: (client: Client) => Promise<{
    usage: {
        hourly_cost: string;
        monthly_estimate: string;
        per_mb_hour: string;
        per_mb_served: string;
        pinned_bytes: number;
        served_bytes_period: number;
    };
}>;
export type Upload = Res<'/ipfs/uploads/{id}', 'get'>['upload'];
export type AddFileOptions = Readonly<{
    /** Display name for the pin. */
    name?: string;
    /** 'file' (default) or 'car' for a client-packed CAR archive. */
    format?: 'file' | 'car';
    /** string → string metadata. */
    meta?: Readonly<Record<string, string>>;
    /** Initial poll interval (default 1000, backing off to an 8 s cap). */
    intervalMs?: number;
    /** Overall deadline (default 300000). */
    timeoutMs?: number;
}>;
/**
 * Upload local content to IPFS end to end: start an upload grant, POST the
 * bytes to the grant URL, poll until the upload completes, and return the
 * final upload (with `cid` and `pin_id`). SOURCE is a file path, bytes, a
 * Blob, or a ReadableStream. Throws an uploadFailed error when the upload
 * fails or expires, or a timeout error when the deadline passes first.
 */
export declare const addFile: (client: Client, source: string | http.UploadSource, options?: AddFileOptions) => Promise<Upload>;