跳转到主要内容

概览

可校验性是 Bluesky / AT Protocol 的重要概念之一。

校验帖子

可以校验通过 com.atproto.repo.getRecord 获取的帖子数据的 CID 是否与 record 一致。
$block = [
    'uri' => 'at://did:plc:***/app.bsky.feed.post/***',
    'cid' => 'bafyreih5y47li4zuvvzevmq4xl7woqxchfc2pnfclv3kfz3zefb2qd3bzm',
    'value' => [
        'text' => 'Hello, Bluesky!',
        '$type' => 'app.bsky.feed.post',
        'createdAt' => '2025-01-01T00:00:00.000Z',
    ],
];
use Revolution\Bluesky\Core\CBOR;
use Revolution\Bluesky\Core\CID;

$cid = data_get($block, 'cid');
$record = data_get($block, 'value');

// 编码为 DAG-CBOR
$cbor = CBOR::encode($record);

$bool = CID::verify($cbor, $cid);
参考实现: DownloadRecordCommand

校验图片文件

在含图片的帖子中,$link 就是图片的 CID。
$block = [
    'uri' => 'at://did:plc:***/app.bsky.feed.post/***',
    'cid' => 'b+++',
    'value' => [
        'text' => '带图片的帖子',
        '$type' => 'app.bsky.feed.post',
        'embed' => [
            '$type' => 'app.bsky.embed.images',
            'images' => [
                [
                    'alt' => '',
                    'image' => [
                        'ref' => [
                            '$link' => 'b***image'
                        ],
                        'size' => 100000,
                        '$type' => 'blob',
                        'mimeType' => 'image/jpeg'
                    ],
                    'aspectRatio' => [
                        'width' => 1000,
                        'height' => 1000
                    ]
                ]
            ]
        ],
        'createdAt' => '2025-01-01T00:00:00.000Z'
    ]
];
校验通过 com.atproto.sync.getBlob 下载得到的图片原始数据。
use Revolution\Bluesky\Core\CID;

// 图片的 CID 来自 $link
$cid = data_get($block, 'value.embed.images.0.image.ref.$link');
$file = file_get_contents('path/to/b***image.jpg');

$bool = CID::verify($file, $cid, codec: CID::RAW);
参考实现: DownloadBlobsCommand

校验 CAR 文件

CAR 文件包含某个用户的所有 record。 可以校验通过 com.atproto.sync.getRepo 下载的 CAR 文件是否属于目标用户。
use Revolution\Bluesky\Core\CAR;
use Revolution\Bluesky\Crypto\DidKey;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

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

// 校验需要 didDoc 中的公钥
$didDoc = DidDocument::make(Bluesky::identity()->resolveDID($did)->json());

$didKey = DidKey::parse($didDoc->publicKey());

$car = 'CAR 文件的原始数据或指向该文件的 stream';

$signed = CAR::signedCommit($car);

$bool = CAR::verifySignedCommit($signed, $didKey);
参考实现: DownloadRepoCommand

校验 CAR 文件展开后的 record

展开 CAR 文件后取得的 record,其校验方法与开头帖子的例子相同。 参考实现: UnpackRepoCommand
最后修改于 2026年7月13日