anttp 0.26.0

AntTP is an HTTP server for the Autonomi Network
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# Chunks

Chunks are the most basic unit of immutable data on the Autonomi Network. Large files are broken down into multiple chunks (typically up to 1MB each) before being uploaded.

## Data Flow

The following diagram illustrates the flow of creating and retrieving a chunk through AntTP.

### Create Chunk Flow
```mermaid
sequenceDiagram
    participant Client
    participant AntTP
    participant Cache
    participant Autonomi

    Client->>AntTP: POST /anttp-0/chunk (Data)
    AntTP->>AntTP: Chunk Data
    AntTP->>Autonomi: Store Chunk
    Autonomi-->>AntTP: Chunk Address
    AntTP->>Cache: Cache Chunk
    AntTP-->>Client: Chunk Address
```

### Get Chunk Flow
```mermaid
sequenceDiagram
    participant Client
    participant AntTP
    participant Cache
    participant Autonomi

    Client->>AntTP: GET /anttp-0/chunk/{address}
    AntTP->>Cache: Check Cache
    alt In Cache
        Cache-->>AntTP: Data
    else Not In Cache
        AntTP->>Autonomi: Retrieve Chunk
        Autonomi-->>AntTP: Data
        AntTP->>Cache: Cache Chunk
    end
    AntTP-->>Client: Data
```

## API Endpoints

### REST API
*   `POST /anttp-0/chunk`: Upload a JSON-wrapped chunk.
*   `POST /anttp-0/binary/chunk`: Upload raw binary data to be chunked.
*   `GET /anttp-0/chunk/{address}`: Retrieve a JSON-wrapped chunk.
*   `GET /anttp-0/binary/chunk/{address}`: Retrieve raw binary data.

### MCP Tools
*   `create_chunk`: Creates a new chunk on the network.
*   `get_chunk`: Retrieves a chunk by its address.

### gRPC API
*   `PutChunk`: Uploads a chunk.
*   `GetChunk`: Retrieves a chunk.

## Storage Options (`x-store-type`)
When uploading chunks, you can use the `x-store-type` header to control persistence:
*   `Network`: Upload to the Autonomi Network.
*   `Disk`: Store only in the local AntTP disk cache.
*   `Memory`: Store only in the local AntTP memory cache. As above, but resets on restart.

---
[Up](../../README.md) | [Next >>](files.md)