Core — AT Protocol Core Operations

use Revolution\Bluesky\Core\CBOR;

$record = [
    '$type'     => 'app.bsky.feed.post',
    'text'      => 'Hello, Bluesky!',
    'createdAt' => '2025-01-01T00:00:00.000Z',
];

$bytes = CBOR::encode($record); // binary string

use Revolution\Bluesky\Core\CBOR;

// Decode a single item
$data = CBOR::decode($bytes);

// Decode the first item from a stream and return the remainder
[$item, $remainder] = CBOR::decodeFirst($bytes);

// Decode all items from a stream
$items = CBOR::decodeAll($bytes);

use Revolution\Bluesky\Core\CBOR;
use Revolution\Bluesky\Core\CID;

$record = data_get($block, 'value');
$cbor   = CBOR::encode($record);
$bool   = CID::verify($cbor, data_get($block, 'cid'));

use Revolution\Bluesky\Core\CID;

// Generate a CID from data
$cid = CID::encode($data, CID::DAG_CBOR); // for records
$cid = CID::encode($data, CID::RAW);      // for binary (images, etc.)

// Verify data against a CID
$bool = CID::verify($data, $cid, CID::DAG_CBOR);
$bool = CID::verify($file, $cid, CID::RAW);

// Parse a CID
$decoded = CID::decode($cid); // ['version', 'codec', 'hash']

// Detect CID version
$version = CID::version($cid); // 0 or 1

// Convert between CID string and raw bytes
$bytes = CID::decodeBytes($cid);
$cid   = CID::encodeBytes($bytes);

use Revolution\Bluesky\Core\CAR;

// Decode the entire CAR file (roots + all blocks)
['roots' => $roots, 'blocks' => $blocks] = CAR::decode($carData);

// Get only the root CIDs
$roots = CAR::decodeRoots($carData);

// Iterate over blocks
foreach (CAR::blockIterator($carData) as [$cid, $block]) {
    // $cid: CID string, $block: binary data
}

// Get records as a map
foreach (CAR::blockMap($carData) as $key => $record) {
    // $key: record key, $record: decoded array
}

use Revolution\Bluesky\Core\CAR;
use Revolution\Bluesky\Crypto\DidKey;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$did = 'did:plc:***';

$didDoc    = DidDocument::make(Bluesky::identity()->resolveDID($did)->json());
$publicKey = DidKey::parse($didDoc->publicKey());

$signed = CAR::signedCommit($carData);
$bool   = CAR::verifySignedCommit($signed, $publicKey);

Example: 3jujm55ngfc24

use Revolution\Bluesky\Core\TID;

// Generate the next TID
$tid = TID::next();
echo $tid->toString(); // e.g. "3jujm55ngfc24"

// Create a TID from a string
$tid = TID::fromStr('3jujm55ngfc24');

// Create a TID from a timestamp (microseconds) and clock ID
$tid = TID::fromTime(microtime(true) * 1000000, 0);

use Revolution\Bluesky\Core\Varint;

// Encode an integer
$bytes = Varint::encode(1234);

// Decode from a stream (returns value and bytes consumed)
[$value, $bytesRead] = Varint::decodeStream($stream);

// Can be used directly in tests
$bytes = CBOR::encode(['text' => 'Hello']);
$cid   = CID::encode($bytes, CID::DAG_CBOR);
$bool  = CID::verify($bytes, $cid);