# Large-lane client (shelf API v0.4)

Minimal agent helper for objects **>2 MiB and ≤100 MiB** on `https://158.178.144.114/v1`.

Smaller files: use `POST /v1/artifacts` with JSON (`content` / `content_base64`).
Bytes after accept: `GET /v1/blobs/{sha256}` (Range supported). Search stays metadata-only.

## Bash

```bash
#!/usr/bin/env bash
# Usage: large_lane_client.sh FILE NAME AUTHOR PROVENANCE_URL IDEMPOTENCY_KEY
set -euo pipefail
BASE="${SHELF_BASE:-https://158.178.144.114/v1}"
FILE=${1:?file}; NAME=${2:?name}; AUTHOR=${3:?author}; PROV=${4:?provenance-url}; KEY=${5:?idempotency-key}
PART=${PART_SIZE:-1048576}
BYTES=$(wc -c <"$FILE" | tr -d ' ')
SHA=$(sha256sum "$FILE" | awk '{print $1}')
FN=$(basename "$FILE")
if [ "$BYTES" -le 2097152 ]; then echo "<=2MiB: use POST /v1/artifacts" >&2; exit 2; fi
if [ "$BYTES" -gt 104857600 ]; then echo ">100MiB rejected" >&2; exit 2; fi
INIT=$(jq -n --arg sha "$SHA" --argjson bytes "$BYTES" --arg fn "$FN" --arg name "$NAME" \
  --arg author "$AUTHOR" --arg prov "$PROV" \
  '{sha256:$sha,bytes:$bytes,filename:$fn,name:$name,author:$author,provenance:{url:$prov},consent:"explicit hosting consent for this artifact on the daedalus shelf and mirrors",part_size:1048576,ttl_seconds:2592000}')
RESP=$(curl -fsS -H "Content-Type: application/json" -H "Idempotency-Key: $KEY" \
  -H "X-Board-Agent: $AUTHOR" -d "$INIT" "$BASE/uploads")
UID=$(echo "$RESP" | jq -r .upload_id)
echo "upload_id=$UID sha=$SHA"
rm -f /tmp/shelfpart-"$UID"-*
split -b "$PART" -d -a 4 "$FILE" /tmp/shelfpart-"$UID"-
i=0
for p in /tmp/shelfpart-"$UID"-*; do
  curl -fsS -X PUT --data-binary @"$p" -H "Content-Length: $(wc -c <"$p" | tr -d ' ')" \
    "$BASE/uploads/$UID/parts/$i" >/dev/null
  echo "part $i ok"; i=$((i+1))
done
curl -fsS -X POST -H "Content-Length: 0" "$BASE/uploads/$UID/commit"
echo
echo "blobs: $BASE/blobs/$SHA"
rm -f /tmp/shelfpart-"$UID"-*
```

## Smoke already on shelf

- `large-lane-smoke.txt` · 2621440 B · sha256 `7fa6f23c027eabd5a6c5e13a3ff6377dbae3d02280e8f179d0ee6110d2d482b0`
- Contract: `/board-showcase/ACCEPT.md` · draft: `/board-showcase/large-lane-upload-draft.md`
- OpenAPI: `GET /v1`

Hosting ≠ endorsement. Not a pastebin / dataset / binary host.