The communication between our SDK and API+sandboxes is documented in our infra repo:

• API for creating a sandbox, etc. (OpenAPI) — https://github.com/e2b-dev/infra/blob/main/spec/openapi.yml
• Sandbox communication (OpenAPI, Protobuffers, ConnectRpc) — https://github.com/e2b-dev/infra/tree/main/packages/envd/spec, it is HTTP1.1 with server streams, but generated from protobuffer spec
• You can check the reference implementation in TypeScript — https://github.com/e2b-dev/E2B/tree/beta/packages/js-sdk. The protocol we use for most of the sandbox interactions is a very thin wrapper around HTTP/1.1 + protobuffers. We essentially wrote the Python client for this as it requires only some custom framing of messages, so generating that part of the SDK that is compatible with custom SDK should be possible
• We will be adding the spec for the code interpreting API soon. We are not generating it right now because of the server streams. The server that you use for code executing running inside the sandbox is here, and the TS client can be found here.
• All interactions with the sandbox and API can also be done with just an HTTP request (I will send you an example using curl), but it is way more convenient to use the generated clients, especially for the sandbox interactions

Example of using curl to execute code in a sandbox

[#!/bin/bash

E2B_API_KEY=${E2B_API_KEY}

create_sandbox() {
  local template="code-interpreter-beta"
  local timeout=10 # Timeout in seconds

  response=$(curl -s -X POST "<https://api.e2b.dev/sandboxes>" \\
    -H "X-API-Key: $E2B_API_KEY" \\
    -H "Content-Type: application/json" \\
    -d '{
      "templateID": "'"$template"'",
      "timeout": '"$timeout"'
    }')

  sandbox_id=$(echo $response | jq -r '.sandboxID')-$(echo $response | jq -r '.clientID')
  if [ "$sandbox_id" = "-" ]; then
    echo "Sandbox creation failed"
    echo $response
    exit 1
  fi

  echo $sandbox_id
}

execute_code() {
  local sandbox_id=$1
  local code=$2

  response=$(curl -s -X POST "https://49999-$sandbox_id.e2b.dev/execute" \\
    -N \\
    -H "Authorization: Bearer $E2B_API_KEY" \\
    -H "Content-Type: application/json" \\
    -d '{"code": "'"$code"'"}')

  while read -r line; do
    echo "$line" | jq -r 'select(.type == "stdout" or .type == "stderr" or .type == "result" or .type == "error")'
  done < <(echo "$response")
}

# Function to kill the sandbox
kill_sandbox() {
  local sandbox_id=$1

  curl -s -X DELETE "<https://api.e2b.dev/sandboxes/$sandbox_id>" -H "X-API-Key: $E2B_API_KEY"
}

printf "Creating sandbox...\\n"
sandbox_id=$(create_sandbox)

# Code to execute. It needs to be Json escaped
code='print(\\"Hello, World!\\")'
printf "Executing code...\\n"
execute_code $sandbox_id "$code"

printf "Killing sandbox...\\n"
kill_sandbox $sandbox_id](<https://e2bdev.notion.site/public-How-to-migrate-to-the-Foxtrot-cluster-199b8c296873809685d7fe6566747698>)