CAR Import (DAG Import)

Importer hele IPFS DAG-er i en enkelt forespørsel ved hjelp av CAR-filer (Content Addressable aRchive). Dine CID-er bevares nøyaktig — ingen re-chunking eller re-hashing.

Hva er en CAR-fil?

En CAR-fil pakker et helt IPFS-katalogtre eller DAG inn i et enkelt portabelt arkiv. Hver blokk lagres med sin opprinnelige CID, så tjenesten importerer alt som det er. Dette betyr:

• CID-bevaring — beregn CID-er lokalt, verifiser at tjenesten returnerer nøyaktig samme CID
• Masseopplasting — last opp hundrevis av filer i en forespørsel i stedet for en og en
• Leverandørmigrering — eksporter en DAG fra en annen leverandør, importer til IPFS Ninja med identiske CID-er
• Egendefinerte DAG-er — last opp hvilken som helst IPLD-datastruktur direkte

REST API

POST /upload/new

Samme endpoint som vanlige opplastinger — legg til car: true for å signalisere en CAR-import.

Forespørselskropp

Parameter	Type	Påkrevd	Beskrivelse
content	string	Ja	Base64-kodet CAR-fil
car	boolean	Ja	Sett til true for å aktivere CAR-import
description	string	Nei	Kort beskrivelse av importen
folderId	string	Nei	Mappe-ID for å organisere det importerte innholdet
metadata	object	Nei	Egendefinerte nøkkel-verdi-par (samme regler som vanlige opplastinger)

Eksempel: Importer en CAR-fil med curl

Steg 1: Opprett en CAR-fil fra en lokal katalog ved hjelp av ipfs-car:

npx ipfs-car pack ./my-directory -o my-archive.car

Steg 2: Last opp CAR-filen:

curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d "{
    \"content\": \"$(base64 -w0 my-archive.car)\",
    \"car\": true,
    \"description\": \"My directory import\"
  }"

Eksempel: Importer en CAR-fil med JavaScript

import fs from "fs";

const carBuffer = fs.readFileSync("my-archive.car");
const base64Content = carBuffer.toString("base64");

const response = await fetch("https://api.ipfs.ninja/upload/new", {
  method: "POST",
  headers: {
    "X-Api-Key": "bws_your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    content: base64Content,
    car: true,
    description: "My directory import"
  })
});

const result = await response.json();
console.log("Root CID:", result.cid);
console.log("Gateway:", result.uris.url);

Eksempel: Importer en CAR-fil med Python

import requests
import base64

with open("my-archive.car", "rb") as f:
    car_content = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.ipfs.ninja/upload/new",
    headers={
        "X-Api-Key": "bws_your_api_key_here",
        "Content-Type": "application/json"
    },
    json={
        "content": car_content,
        "car": True,
        "description": "My directory import"
    }
)

result = response.json()
print("Root CID:", result["cid"])
print("Gateway:", result["uris"]["url"])

Respons 200 OK

{
  "cid": "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
  "sizeMB": 4.2,
  "car": true,
  "uris": {
    "ipfs": "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
    "url": "https://ipfs.ninja/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi"
  }
}

S3-kompatibelt API

Bruk x-amz-meta-import: car-headeren på en PutObject-forespørsel for å importere en CAR-fil via S3 API.

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
import fs from "fs";

const s3 = new S3Client({
  endpoint: "https://s3.ipfs.ninja",
  credentials: {
    accessKeyId: "bws_628bba35",
    secretAccessKey: "bws_628bba35e9e0079d9ff9c392b1b55a7b"
  },
  region: "us-east-1",
  forcePathStyle: true
});

const result = await s3.send(new PutObjectCommand({
  Bucket: "my-project",
  Key: "my-archive.car",
  Body: fs.readFileSync("my-archive.car"),
  ContentType: "application/vnd.ipld.car",
  Metadata: { import: "car" }   // ← utløser CAR-import
}));

console.log("Root CID:", result.ETag);

MCP Server

Verktøyet ipfs_import_car er tilgjengelig i MCP Server (v1.3.0+):

You: Import my-archive.car to IPFS
Claude: [calls ipfs_import_car with base64 content]
     → Root CID: bafybeig... — https://ipfs.ninja/ipfs/bafybeig...

Opprette CAR-filer

Fra en katalog (anbefalt)

Bruk ipfs-car CLI-verktøyet:

# Installer
npm install -g ipfs-car

# Pakk en katalog inn i en CAR-fil
ipfs-car pack ./my-directory -o my-archive.car

# Sjekk rot-CID før opplasting
ipfs-car roots my-archive.car
# bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Fra en kjørende IPFS-node

Eksporter hvilken som helst CID som en CAR-fil ved hjelp av Kubo CLI:

ipfs dag export QmXyz... > my-archive.car

Programmatisk med JavaScript

Bruk @ipld/car-biblioteket:

import { CarWriter } from "@ipld/car";
import { CID } from "multiformats/cid";
import * as raw from "multiformats/codecs/raw";
import { sha256 } from "multiformats/hashes/sha2";

// Create blocks
const block1 = new TextEncoder().encode("Hello, IPFS!");
const hash1 = await sha256.digest(block1);
const cid1 = CID.create(1, raw.code, hash1);

// Write CAR
const { writer, out } = CarWriter.create([cid1]);
writer.put({ cid: cid1, bytes: block1 });
writer.close();

// Collect output
const chunks = [];
for await (const chunk of out) chunks.push(chunk);
const carBuffer = Buffer.concat(chunks);

Verifisering av CID-integritet

Den viktigste fordelen med CAR-import er CID-bevaring. Du kan verifisere at rot-CID-en stemmer overens før og etter opplasting:

# 1. Pakk katalogen og noter rot-CID
ipfs-car pack ./my-nft-collection -o collection.car
ipfs-car roots collection.car
# bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

# 2. Last opp til IPFS Ninja
curl -s -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"$(base64 -w0 collection.car)\", \"car\": true}" \
  | jq .cid
# "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi"
# ✓ CID-er stemmer — innhold importert nøyaktig slik det ble bygget lokalt

Migrering fra en annen leverandør

Fra Pinata

# Eksporter fra Pinata ved hjelp av IPFS gateway
ipfs dag export QmYourCID > export.car

# Importer til IPFS Ninja
curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"$(base64 -w0 export.car)\", \"car\": true}"

Fra Filebase

# Filebase støtter CAR-eksport via deres S3 API
aws s3 cp s3://your-bucket/your-file.car export.car \
  --endpoint-url https://s3.filebase.com

# Importer til IPFS Ninja
curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key" \
  -H "Content-Type: application/json" \
  -d "{\"content\": \"$(base64 -w0 export.car)\", \"car\": true}"

Begrensninger

Begrensning	Verdi
Maks CAR-filstørrelse	100 MB
Maks enkelt rot	Må ha minst en rot-CID
CAR-format	CARv1 (universelt støttet)
Tilgjengelighet	Alle planer (Dharma, Bodhi, Nirvana)

Lagrings- og filantallsbegrensninger fra planen din gjelder. Den importerte DAG-en teller som en filoppføring, og CAR-filstørrelsen trekkes fra lagringskvoten din.

Feilsøking

"invalid CAR file: too small"

Det opplastede innholdet er mindre enn 40 byte, noe som er for lite til å være en gyldig CAR-fil. Sørg for at du sender fullt base64-kodet CAR-innhold.

"File too large. Maximum upload size is 100 MB."

Den dekodede CAR-filen overskrider 100 MB. Del innholdet ditt i flere mindre CAR-filer ved hjelp av carbites-pakken, eller last opp filer enkeltvis.

"dag/import did not return a root CID"

IPFS-noden klarte ikke å behandle CAR-filen. Verifiser at filen er et gyldig CARv1-arkiv:

ipfs-car roots my-archive.car

Hvis denne kommandoen feiler, er CAR-filen feilformatert. Generer den på nytt med ipfs-car pack eller ipfs dag export.

"not enough storage"

Lagringsgrensen for planen din er nådd. Slett ubrukte filer eller oppgrader planen din på ipfs.ninja/pricing.