import {
RelayAgentActivityPublishProofPayload,
RelayAgentActivityPublishProofInvalidReason,
type RelayAgentActivityPublishRequest,
} from "@t3tools/contracts/relay";
import {
decodeRelayJwt,
normalizeRelayIssuer,
RELAY_ACTIVITY_PUBLISH_TYP,
verifyRelayJwt,
} from "@t3tools/shared/relayJwt";
import { stableStringify } from "@t3tools/shared/relaySigning";
import * as Context from "effect/Context";
import * as Digest from "effect/crypto/Digest";
import * as Signature from "effect/crypto/Signature";
import * as DateTime from "effect/DateTime";
import * as Effect from "effect/Effect";
import * as Base64Url from "effect/encoding/Base64Url";
import * as Layer from "effect/Layer";
import * as Schema from "effect/Schema";
import * as DpopProofs from "../auth/DpopProofs.ts";
import * as RelayConfiguration from "../Config.ts";
export class EnvironmentPublishSignatureExpired extends Schema.TaggedError<EnvironmentPublishSignatureExpired>()(
"EnvironmentPublishSignatureExpired",
{
environmentId: Schema.String,
threadId: Schema.String,
expiresAt: Schema.String,
},
) {
override get message(): string {
return `Environment '${this.environmentId}' publish signature for thread '${this.threadId}' expired at ${this.expiresAt}`;
}
}
export class EnvironmentPublishSignatureInvalid extends Schema.TaggedError<EnvironmentPublishSignatureInvalid>()(
"EnvironmentPublishSignatureInvalid",
{
environmentId: Schema.String,
threadId: Schema.String,
reason: RelayAgentActivityPublishProofInvalidReason,
stage: Schema.Literals([
"decode_token",
"verify_proof",
"validate_claims",
"validate_expiration",
"generate_replay_thumbprint",
"consume_nonce",
]),
cause: Schema.optional(Schema.Defect()),
},
) {
override get message(): string {
return `Environment '${this.environmentId}' publish signature for thread '${this.threadId}' is invalid during ${this.stage}: ${this.reason}`;
}
}
export type EnvironmentPublishSignatureError =
| EnvironmentPublishSignatureExpired
| EnvironmentPublishSignatureInvalid
| DpopProofs.DpopProofReplayPersistenceError;
export class EnvironmentPublishSignatures extends Context.Service<
EnvironmentPublishSignatures,
{
readonly verify: (input: {
readonly environmentId: string;
readonly environmentPublicKey: string;
readonly threadId: string;
readonly request: RelayAgentActivityPublishRequest;
}) => Effect.Effect<void, EnvironmentPublishSignatureError>;
}
>()("t3code-relay/environments/EnvironmentPublishSignatures") {}
function environmentPublishReplayThumbprintData(input: {
readonly environmentId: string;
readonly environmentPublicKey: string;
}) {
return new TextEncoder().encode(
stableStringify({
environmentId: input.environmentId,
environmentPublicKey: input.environmentPublicKey,
}),
);
}
const formatEnvironmentPublishReplayThumbprint = (digest: Uint8Array) =>
`env-publish:${Base64Url.encode(digest)}`;
const make = Effect.gen(function* () {
const proofReplay = yield* DpopProofs.DpopProofReplay;
const config = yield* RelayConfiguration.RelayConfiguration;
const crypto = yield* Digest.Digest;
const signature = yield* Signature.Signature;
return EnvironmentPublishSignatures.of({
verify: Effect.fn("relay.environment_publish_signatures.verify")(function* (input) {
yield* Effect.annotateCurrentSpan({
"relay.environment_id": input.environmentId,
"relay.thread_id": input.threadId,
});
const now = yield* DateTime.now;
const decoded = yield* decodeRelayJwt(input.request.proof).pipe(
Effect.mapError(
(cause) =>
new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "invalid_signature_or_payload",
stage: "decode_token",
cause,
}),
),
);
if (
typeof decoded.exp === "number" &&
decoded.exp <= Math.floor(now.epochMilliseconds / 1_000)
) {
return yield* new EnvironmentPublishSignatureExpired({
environmentId: input.environmentId,
threadId: input.threadId,
expiresAt: DateTime.formatIso(DateTime.makeUnsafe(decoded.exp * 1_000)),
});
}
const proof = yield* verifyRelayJwt(RelayAgentActivityPublishProofPayload, {
publicKey: input.environmentPublicKey,
token: input.request.proof,
typ: RELAY_ACTIVITY_PUBLISH_TYP,
issuer: `t3-env:${input.environmentId}`,
audience: normalizeRelayIssuer(config.relayIssuer),
}).pipe(
Effect.provideService(Signature.Signature, signature),
Effect.mapError(
(cause) =>
new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "invalid_signature_or_payload",
stage: "verify_proof",
cause,
}),
),
);
if (
proof.environmentId !== input.environmentId ||
proof.threadId !== input.threadId ||
proof.sub !== input.environmentId ||
stableStringify(proof.state) !== stableStringify(input.request.state) ||
(input.request.state !== null &&
(input.request.state.environmentId !== input.environmentId ||
input.request.state.threadId !== input.threadId))
) {
return yield* new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "invalid_signature_or_payload",
stage: "validate_claims",
});
}
const expiresAt = DateTime.make(proof.exp * 1_000);
if (expiresAt._tag === "None") {
return yield* new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "invalid_signature_or_payload",
stage: "validate_expiration",
});
}
const thumbprint = yield* crypto
.digest(
Digest.sha256,
environmentPublishReplayThumbprintData({
environmentId: input.environmentId,
environmentPublicKey: input.environmentPublicKey,
}),
)
.pipe(
Effect.map(formatEnvironmentPublishReplayThumbprint),
Effect.mapError(
(cause) =>
new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "invalid_signature_or_payload",
stage: "generate_replay_thumbprint",
cause,
}),
),
);
const consumedNonce = yield* proofReplay.consume({
thumbprint,
jti: proof.jti,
iat: proof.iat,
expiresAt: expiresAt.value,
});
if (!consumedNonce) {
return yield* new EnvironmentPublishSignatureInvalid({
environmentId: input.environmentId,
threadId: input.threadId,
reason: "replayed_nonce",
stage: "consume_nonce",
});
}
}),
});
});
export const layer = Layer.effect(EnvironmentPublishSignatures, make);