@tetsuo-ai/marketplace-react 0.3.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import { createReadTransport } from './chunk-AKPPKMQ2.js';
2
2
  export { ReadTransportUnsupportedError, createReadTransport } from './chunk-AKPPKMQ2.js';
3
3
  export { EN_SIGNER_STRINGS, signerFromEmbeddedWallet, signerFromWalletAccount, signerFromWalletAdapter } from './chunk-ON6XR4XO.js';
4
- export { AGENC_THEME_CLASS, AGENC_TOKENS_CSS_PATH, Badge, Button, COMPONENT_CATALOG, DEFAULT_TRUST_HREF, DisputeBanner, EN_COMPONENT_STRINGS, HireButton, HireCheckoutModal, ListingCard, ListingGrid, Modal, ModerationBadge, PoweredByAgenC, ProviderCard, ReferrerDisclosure, ReviewPanel, Spinner, StateMessage, TaskTimeline, UNVERIFIED, VerifiedBadge, agencThemeStyleTag, agentVerificationReaderFromRpc, cx, decodeListingCategory, decodeListingName, decodeListingTags, elementClass, evaluateAgentVerification, formatPriceSol, formatRate, formatSol, moderationStateOf, resolveThemeClassName, rootClass, tc, toHex, truncateAddress, useAgentVerification, useFocusTrap } from './chunk-ZAMIL27X.js';
5
- import { AgencContext } from './chunk-2Y6JN2VZ.js';
6
- export { AgencContext, useAgencContext } from './chunk-2Y6JN2VZ.js';
4
+ export { AGENC_THEME_CLASS, AGENC_TOKENS_CSS_PATH, Badge, Button, COMPONENT_CATALOG, DEFAULT_TRUST_HREF, DisputeBanner, EN_COMPONENT_STRINGS, HireButton, HireCheckoutModal, ListingCard, ListingGrid, Modal, ModerationBadge, PoweredByAgenC, ProviderCard, ReferrerDisclosure, ReviewPanel, Spinner, StateMessage, TaskTimeline, UNVERIFIED, VerifiedBadge, agencThemeStyleTag, agentVerificationReaderFromRpc, cx, decodeListingCategory, decodeListingName, decodeListingTags, elementClass, evaluateAgentVerification, formatPriceSol, formatRate, formatSol, moderationStateOf, resolveThemeClassName, rootClass, tc, toHex, truncateAddress, useAgentVerification, useFocusTrap } from './chunk-BNILOX3O.js';
5
+ import { AgencContext } from './chunk-BTAVED7S.js';
6
+ export { AgencContext, useAgencContext } from './chunk-BTAVED7S.js';
7
7
  import { t } from './chunk-H6PJIDQR.js';
8
8
  export { EN_STRINGS, t } from './chunk-H6PJIDQR.js';
9
9
  import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tetsuo-ai/marketplace-react",
3
- "version": "0.3.2",
3
+ "version": "0.4.0",
4
4
  "description": "Headless React hooks + themable components for the AgenC marketplace — provider, indexer-first read transport, and live referrer config",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -87,7 +87,7 @@
87
87
  "peerDependencies": {
88
88
  "@solana/kit": "^6.9.0",
89
89
  "@solana/program-client-core": "^6.4.0",
90
- "@tetsuo-ai/marketplace-sdk": "^0.7.0",
90
+ "@tetsuo-ai/marketplace-sdk": "^0.8.0",
91
91
  "react": ">=18"
92
92
  },
93
93
  "dependencies": {
@@ -1,98 +1,217 @@
1
1
  /**
2
- * Resolve the OPTIONAL `moderation_attestor` roster account for task
3
- * activation (WP-A1).
2
+ * Resolve the P1.2 moderation accounts a consumption gate needs.
4
3
  *
5
- * Post-A1 the on-chain publish gate (`set_task_job_spec`) accepts a task
6
- * moderation authored by a registered roster `ModerationAttestor` — but ONLY
7
- * when the transaction attaches that attestor's roster-entry PDA. Without it
8
- * the gate falls back to requiring `task_moderation.moderator ==
9
- * moderation_config.moderation_authority`, so a roster-attested task (the
10
- * default when the activation backend uses the public attestation service)
11
- * fails with `UNAUTHORIZED_TASK_MODERATOR` even though the attestation is
12
- * valid.
4
+ * Post-P1.2 (open roster) every consumption gate — `set_task_job_spec` for
5
+ * activation, `hire_from_listing`/`hire_from_listing_humanless` for hires —
6
+ * names an explicit `moderator` whose attestation it consumes, and the
7
+ * moderation record lives at the v2 moderator-keyed seeds
8
+ * (`["task_moderation_v2", task, hash, moderator]` / the listing mirror). The
9
+ * caller supplies WHO to trust (the `moderator` — reading it from their
10
+ * attestation service, e.g. attest.agenc.ag `GET /v1/info`); these helpers
11
+ * resolve the MECHANICS:
13
12
  *
14
- * This helper reads the recorded `TaskModeration`, compares its stored
15
- * moderator against the global moderation authority, and returns the roster
16
- * PDA exactly when they differ. Any resolution failure returns `undefined`,
17
- * degrading to the pre-resolution behavior — the program stays the
18
- * enforcement point; a read hiccup must never make activation MORE broken
19
- * than not resolving at all.
13
+ * - the roster-entry PDA (`["moderation_attestor", moderator]`) the gate
14
+ * requires whenever the moderator is a registered attestor rather than the
15
+ * global `moderation_authority`;
16
+ * - the legacy grace window: when no v2 record exists but a PRE-upgrade record
17
+ * authored by the SAME moderator sits at the frozen legacy seeds, the gate
18
+ * still accepts it if the transaction points at it explicitly — so the
19
+ * resolver returns that record override.
20
+ *
21
+ * Any resolution failure degrades to "no overrides" — the program stays the
22
+ * enforcement point; a read hiccup must never make the flow MORE broken than
23
+ * not resolving at all.
20
24
  *
21
25
  * @module hooks/moderation-attestor
22
26
  */
23
27
  import { createSolanaRpc } from "@solana/kit";
24
28
  import {
29
+ facade,
30
+ fetchMaybeListingModeration,
31
+ fetchMaybeModerationAttestor,
25
32
  fetchMaybeModerationConfig,
26
33
  fetchMaybeTaskModeration,
34
+ findListingModerationPda,
27
35
  findModerationAttestorPda,
28
36
  findModerationConfigPda,
29
37
  findTaskModerationPda,
30
38
  } from "@tetsuo-ai/marketplace-sdk";
31
39
  import type { Address } from "../types.js";
32
40
 
33
- /** The account-read slice of a kit RPC that the resolver needs. */
41
+ /** The account-read slice of a kit RPC that the resolvers need. */
34
42
  type AccountReadRpc = Parameters<typeof fetchMaybeTaskModeration>[0];
35
43
 
36
- /** The job-spec hash exactly as the TaskModeration PDA seeds accept it. */
44
+ /** The job-spec hash exactly as the moderation-record PDA seeds accept it. */
37
45
  type JobSpecHashSeed = Parameters<typeof findTaskModerationPda>[0]["jobSpecHash"];
38
46
 
47
+ /** Moderation accounts resolved for a task activation (`set_task_job_spec`). */
48
+ export interface ActivationModerationAccounts {
49
+ /** Roster-entry PDA to attach, absent on the global-authority path. */
50
+ moderationAttestor?: Address;
51
+ /**
52
+ * Explicit record override — set only when the attestation predates the
53
+ * P1.2 upgrade and lives at the frozen legacy seeds (grace window).
54
+ */
55
+ taskModeration?: Address;
56
+ }
57
+
58
+ /** Moderation accounts resolved for a hire (`hire_from_listing*`). */
59
+ export interface HireListingModerationAccounts {
60
+ /** Roster-entry PDA to attach, absent on the global-authority path. */
61
+ moderationAttestor?: Address;
62
+ /**
63
+ * Explicit record override — set only when the attestation predates the
64
+ * P1.2 upgrade and lives at the frozen legacy seeds (grace window).
65
+ */
66
+ listingModeration?: Address;
67
+ }
68
+
69
+ function readRpc(input: {
70
+ rpcUrl: string | null;
71
+ rpc?: AccountReadRpc;
72
+ }): AccountReadRpc | null {
73
+ return (
74
+ input.rpc ??
75
+ (input.rpcUrl
76
+ ? (createSolanaRpc(input.rpcUrl) as unknown as AccountReadRpc)
77
+ : null)
78
+ );
79
+ }
80
+
39
81
  /**
40
- * Resolve the roster-attestor account to attach to `set_task_job_spec`, or
41
- * `undefined` when none is needed (global-authority moderation, missing
42
- * moderation record, or no read endpoint).
82
+ * Roster vs global-authority: return the `["moderation_attestor", moderator]`
83
+ * roster PDA to attach, or `undefined` when the moderator IS the global
84
+ * moderation authority (the gate's authority branch needs no roster account).
85
+ *
86
+ * The roster PDA is attached ONLY when the entry verifiably exists on-chain:
87
+ * a set-but-uninitialized optional account fails the gate harder than
88
+ * attaching nothing (`AccountNotInitialized` vs the authority branch), so an
89
+ * unreadable/absent entry degrades to "no account" — callers on an exotic
90
+ * setup can still force the roster path with `moderatorIsAttestor`.
91
+ */
92
+ async function resolveRosterEntry(
93
+ rpc: AccountReadRpc,
94
+ moderator: Address,
95
+ ): Promise<Address | undefined> {
96
+ const [moderationConfigPda] = await findModerationConfigPda();
97
+ const moderationConfig = await fetchMaybeModerationConfig(
98
+ rpc,
99
+ moderationConfigPda,
100
+ );
101
+ if (
102
+ moderationConfig.exists &&
103
+ moderationConfig.data.moderationAuthority === moderator
104
+ ) {
105
+ return undefined;
106
+ }
107
+ const [rosterPda] = await findModerationAttestorPda({ attestor: moderator });
108
+ const roster = await fetchMaybeModerationAttestor(rpc, rosterPda);
109
+ return roster.exists ? rosterPda : undefined;
110
+ }
111
+
112
+ /**
113
+ * Resolve the moderation accounts to attach to `set_task_job_spec`, given the
114
+ * `moderator` whose attestation the activation consumes.
43
115
  *
44
116
  * @param input.rpcUrl - Resolved HTTP RPC endpoint (from provider context).
45
117
  * @param input.task - The task PDA being activated.
46
- * @param input.jobSpecHash - The 32-byte canonical job-spec hash (seeds the
47
- * `TaskModeration` PDA together with `task`).
118
+ * @param input.jobSpecHash - The 32-byte canonical job-spec hash.
119
+ * @param input.moderator - The attestation signer the gate should consume
120
+ * (e.g. the attestation service's `moderator` from `GET /v1/info`).
48
121
  * @param input.rpc - Test seam: a pre-built account-read RPC wins over
49
122
  * `rpcUrl`.
50
123
  */
51
- export async function resolveActivationModerationAttestor(input: {
124
+ export async function resolveActivationModerationAccounts(input: {
52
125
  rpcUrl: string | null;
53
126
  task: Address;
54
127
  jobSpecHash: JobSpecHashSeed;
128
+ moderator: Address;
55
129
  rpc?: AccountReadRpc;
56
- }): Promise<Address | undefined> {
130
+ }): Promise<ActivationModerationAccounts> {
57
131
  try {
58
- const rpc =
59
- input.rpc ??
60
- (input.rpcUrl
61
- ? (createSolanaRpc(input.rpcUrl) as unknown as AccountReadRpc)
62
- : null);
63
- if (!rpc) return undefined;
64
-
65
- const [taskModerationPda] = await findTaskModerationPda({
132
+ const rpc = readRpc(input);
133
+ if (!rpc) return {};
134
+
135
+ const moderationAttestor = await resolveRosterEntry(rpc, input.moderator);
136
+ const attestorPart =
137
+ moderationAttestor !== undefined ? { moderationAttestor } : {};
138
+
139
+ // Prefer the v2 moderator-keyed record (what recordTaskModeration writes
140
+ // post-upgrade); the facade derives it by default, so no override needed.
141
+ const [v2Pda] = await findTaskModerationPda({
142
+ task: input.task,
143
+ jobSpecHash: input.jobSpecHash,
144
+ moderator: input.moderator,
145
+ });
146
+ const v2 = await fetchMaybeTaskModeration(rpc, v2Pda);
147
+ if (v2.exists) return attestorPart;
148
+
149
+ // Grace window: a pre-upgrade record at the frozen legacy seeds is still
150
+ // consumable when the transaction points at it explicitly AND it was
151
+ // authored by the same moderator the gate is told to consume.
152
+ const [legacyPda] = await facade.findLegacyTaskModerationPda({
66
153
  task: input.task,
67
154
  jobSpecHash: input.jobSpecHash,
68
155
  });
69
- const taskModeration = await fetchMaybeTaskModeration(
70
- rpc,
71
- taskModerationPda,
72
- );
73
- if (!taskModeration.exists) return undefined;
74
-
75
- const [moderationConfigPda] = await findModerationConfigPda();
76
- const moderationConfig = await fetchMaybeModerationConfig(
77
- rpc,
78
- moderationConfigPda,
79
- );
80
- if (
81
- moderationConfig.exists &&
82
- taskModeration.data.moderator ===
83
- moderationConfig.data.moderationAuthority
84
- ) {
85
- // Global-authority moderation: the gate needs no roster account.
86
- return undefined;
156
+ const legacy = await fetchMaybeTaskModeration(rpc, legacyPda);
157
+ if (legacy.exists && legacy.data.moderator === input.moderator) {
158
+ return { ...attestorPart, taskModeration: legacyPda };
87
159
  }
88
160
 
89
- const [rosterPda] = await findModerationAttestorPda({
90
- attestor: taskModeration.data.moderator,
161
+ return attestorPart;
162
+ } catch {
163
+ // Degrade to "no overrides" — never block the flow on a read failure.
164
+ return {};
165
+ }
166
+ }
167
+
168
+ /**
169
+ * Resolve the moderation accounts to attach to a hire
170
+ * (`hire_from_listing` / `hire_from_listing_humanless`), given the
171
+ * `moderator` whose listing attestation the hire gate should consume.
172
+ *
173
+ * @param input.rpcUrl - Resolved HTTP RPC endpoint (from provider context).
174
+ * @param input.listing - The ServiceListing PDA being hired.
175
+ * @param input.listingSpecHash - The listing's pinned 32-byte `spec_hash`.
176
+ * @param input.moderator - The attestation signer the gate should consume.
177
+ * @param input.rpc - Test seam: a pre-built account-read RPC wins over
178
+ * `rpcUrl`.
179
+ */
180
+ export async function resolveHireListingModerationAccounts(input: {
181
+ rpcUrl: string | null;
182
+ listing: Address;
183
+ listingSpecHash: JobSpecHashSeed;
184
+ moderator: Address;
185
+ rpc?: AccountReadRpc;
186
+ }): Promise<HireListingModerationAccounts> {
187
+ try {
188
+ const rpc = readRpc(input);
189
+ if (!rpc) return {};
190
+
191
+ const moderationAttestor = await resolveRosterEntry(rpc, input.moderator);
192
+ const attestorPart =
193
+ moderationAttestor !== undefined ? { moderationAttestor } : {};
194
+
195
+ const [v2Pda] = await findListingModerationPda({
196
+ listing: input.listing,
197
+ jobSpecHash: input.listingSpecHash,
198
+ moderator: input.moderator,
91
199
  });
92
- return rosterPda;
200
+ const v2 = await fetchMaybeListingModeration(rpc, v2Pda);
201
+ if (v2.exists) return attestorPart;
202
+
203
+ const [legacyPda] = await facade.findLegacyListingModerationPda({
204
+ listing: input.listing,
205
+ jobSpecHash: input.listingSpecHash,
206
+ });
207
+ const legacy = await fetchMaybeListingModeration(rpc, legacyPda);
208
+ if (legacy.exists && legacy.data.moderator === input.moderator) {
209
+ return { ...attestorPart, listingModeration: legacyPda };
210
+ }
211
+
212
+ return attestorPart;
93
213
  } catch {
94
- // Degrade to "no account attached" — never block activation on a read
95
- // failure; the on-chain gate remains the enforcement point.
96
- return undefined;
214
+ // Degrade to "no overrides" — never block the flow on a read failure.
215
+ return {};
97
216
  }
98
217
  }
@@ -28,6 +28,10 @@ import {
28
28
  signerAddress,
29
29
  withoutReferrerArgs,
30
30
  } from "./internal.js";
31
+ import {
32
+ resolveHireListingModerationAccounts,
33
+ type HireListingModerationAccounts,
34
+ } from "./moderation-attestor.js";
31
35
 
32
36
  /**
33
37
  * Input to a standard `hire(...)` — a buyer that has a registered marketplace
@@ -132,6 +136,27 @@ export function useHire(): UseHireResult {
132
136
  const { referrerArgs, referrerInjected } = resolveReferrerArgs(ctx);
133
137
  const hireInput = withoutReferrerArgs(input);
134
138
 
139
+ // P1.2: the hire gate names an explicit `moderator` (the caller's trust
140
+ // decision) and needs the roster-entry PDA when that moderator is a
141
+ // registered attestor, plus a record override when the listing
142
+ // attestation predates the upgrade (legacy grace window). Resolve the
143
+ // mechanics automatically unless the caller supplied any of them.
144
+ const listingSpecHash = input.listingSpecHash;
145
+ let moderationArgs: HireListingModerationAccounts = {};
146
+ if (
147
+ input.moderationAttestor === undefined &&
148
+ input.moderatorIsAttestor === undefined &&
149
+ input.listingModeration === undefined &&
150
+ listingSpecHash !== undefined
151
+ ) {
152
+ moderationArgs = await resolveHireListingModerationAccounts({
153
+ rpcUrl: ctx.rpcUrl,
154
+ listing: input.listing,
155
+ listingSpecHash,
156
+ moderator: input.moderator,
157
+ });
158
+ }
159
+
135
160
  const creator = input.creator ?? client.signer;
136
161
  let signature: string;
137
162
 
@@ -140,6 +165,7 @@ export function useHire(): UseHireResult {
140
165
  // it settles via the buyer review path (useSubmissionReview).
141
166
  const result = await client.hireFromListingHumanless({
142
167
  ...hireInput,
168
+ ...moderationArgs,
143
169
  creator,
144
170
  ...referrerArgs,
145
171
  } as Parameters<typeof facadeNs.hireFromListingHumanless>[0]);
@@ -149,6 +175,7 @@ export function useHire(): UseHireResult {
149
175
  const authority = input.authority ?? client.signer;
150
176
  const result = await client.hireFromListing({
151
177
  ...hireInput,
178
+ ...moderationArgs,
152
179
  authority,
153
180
  creator,
154
181
  ...referrerArgs,
@@ -12,7 +12,11 @@ import {
12
12
  withoutReferrerArgs,
13
13
  type MutationStatus,
14
14
  } from "./internal.js";
15
- import { resolveActivationModerationAttestor } from "./moderation-attestor.js";
15
+ import {
16
+ resolveActivationModerationAccounts,
17
+ resolveHireListingModerationAccounts,
18
+ type HireListingModerationAccounts,
19
+ } from "./moderation-attestor.js";
16
20
  import type { HumanlessHireInput } from "./useHire.js";
17
21
  import type { TaskActivationInput } from "./useTaskActivation.js";
18
22
 
@@ -33,8 +37,15 @@ export type HumanlessHireFlowHireInput = Omit<
33
37
 
34
38
  export type HumanlessHireFlowActivationInput = Omit<
35
39
  TaskActivationInput,
36
- "creator" | "jobSpecHash" | "jobSpecUri"
37
- >;
40
+ "creator" | "jobSpecHash" | "jobSpecUri" | "moderator"
41
+ > & {
42
+ /**
43
+ * Override the activation `moderator` (P1.2). Defaults to the `moderator`
44
+ * returned by `hostAndModerateJobSpec` — the attestation service that
45
+ * signed the task moderation is whose record the publish gate consumes.
46
+ */
47
+ moderator?: TaskActivationInput["moderator"];
48
+ };
38
49
 
39
50
  export type HumanlessHireFlowCreator = HumanlessHireInput["creator"];
40
51
 
@@ -45,6 +56,12 @@ export interface HumanlessHireFlowModerationResult {
45
56
  jobSpecHash: HumanlessHireFlowJobSpecHash;
46
57
  jobSpecUri: string;
47
58
  moderationAttested: boolean;
59
+ /**
60
+ * The pubkey that signed/recorded the task attestation (P1.2) — the
61
+ * attestation service's signer (e.g. attest.agenc.ag `GET /v1/info` →
62
+ * `moderator`). Names whose record the publish gate consumes.
63
+ */
64
+ moderator: Address;
48
65
  moderation?: unknown;
49
66
  }
50
67
 
@@ -114,7 +131,11 @@ function emptyProgress(): HumanlessHireFlowProgress {
114
131
 
115
132
  function validateModerationResult(
116
133
  result: HumanlessHireFlowModerationResult,
117
- ): { jobSpecHash: HumanlessHireFlowJobSpecHash; jobSpecUri: string } {
134
+ ): {
135
+ jobSpecHash: HumanlessHireFlowJobSpecHash;
136
+ jobSpecUri: string;
137
+ moderator: Address;
138
+ } {
118
139
  if (result.moderationAttested !== true) {
119
140
  throw new Error(
120
141
  "Task moderation was not attested; activation was not signed.",
@@ -134,7 +155,16 @@ function validateModerationResult(
134
155
  "Task moderation returned an empty jobSpecUri; activation was not signed.",
135
156
  );
136
157
  }
137
- return { jobSpecHash: result.jobSpecHash, jobSpecUri };
158
+ if (typeof result.moderator !== "string" || !result.moderator.trim()) {
159
+ throw new Error(
160
+ "Task moderation returned no moderator pubkey; activation was not signed.",
161
+ );
162
+ }
163
+ return {
164
+ jobSpecHash: result.jobSpecHash,
165
+ jobSpecUri,
166
+ moderator: result.moderator,
167
+ };
138
168
  }
139
169
 
140
170
  export function useHumanlessHireFlow<TJobSpec = unknown>(): UseHumanlessHireFlowResult<TJobSpec> {
@@ -159,8 +189,26 @@ export function useHumanlessHireFlow<TJobSpec = unknown>(): UseHumanlessHireFlow
159
189
  setProgress(emptyProgress());
160
190
 
161
191
  try {
192
+ // P1.2: resolve the hire gate's moderation mechanics (roster PDA /
193
+ // legacy record override) unless the caller supplied any of them.
194
+ const hireListingSpecHash = input.hire.listingSpecHash;
195
+ let hireModerationArgs: HireListingModerationAccounts = {};
196
+ if (
197
+ input.hire.moderationAttestor === undefined &&
198
+ input.hire.moderatorIsAttestor === undefined &&
199
+ input.hire.listingModeration === undefined &&
200
+ hireListingSpecHash !== undefined
201
+ ) {
202
+ hireModerationArgs = await resolveHireListingModerationAccounts({
203
+ rpcUrl: ctx.rpcUrl,
204
+ listing: input.hire.listing,
205
+ listingSpecHash: hireListingSpecHash,
206
+ moderator: input.hire.moderator,
207
+ });
208
+ }
162
209
  const hireResult = await client.hireFromListingHumanless({
163
210
  ...hireInput,
211
+ ...hireModerationArgs,
164
212
  creator,
165
213
  ...referrerArgs,
166
214
  } as Parameters<typeof facadeNs.hireFromListingHumanless>[0]);
@@ -186,7 +234,8 @@ export function useHumanlessHireFlow<TJobSpec = unknown>(): UseHumanlessHireFlow
186
234
  hireSignature: hireResult.signature,
187
235
  referrerInjected,
188
236
  });
189
- const { jobSpecHash, jobSpecUri } = validateModerationResult(moderation);
237
+ const { jobSpecHash, jobSpecUri, moderator } =
238
+ validateModerationResult(moderation);
190
239
 
191
240
  setProgress((current) => ({
192
241
  ...current,
@@ -195,23 +244,31 @@ export function useHumanlessHireFlow<TJobSpec = unknown>(): UseHumanlessHireFlow
195
244
  }));
196
245
 
197
246
  setPhase("activating");
198
- // WP-A1: attach the roster-attestor account when the moderation was
199
- // authored by a roster attestor (e.g. the public attestation
200
- // service) — without it the publish gate rejects the activation.
201
- const moderationAttestor =
202
- input.activation?.moderationAttestor ??
203
- (await resolveActivationModerationAttestor({
204
- rpcUrl: ctx.rpcUrl,
205
- task: taskPda,
206
- jobSpecHash,
207
- }));
247
+ // P1.2: the publish gate consumes the record of the moderator that
248
+ // signed the attestation (the host callback's service by default).
249
+ // Resolve the gate mechanics (roster PDA / legacy record override)
250
+ // unless the caller supplied any of them.
251
+ const activationModerator = input.activation?.moderator ?? moderator;
252
+ const activationCallerResolved =
253
+ input.activation?.moderationAttestor !== undefined ||
254
+ input.activation?.moderatorIsAttestor !== undefined ||
255
+ input.activation?.taskModeration !== undefined;
256
+ const activationModerationArgs = activationCallerResolved
257
+ ? {}
258
+ : await resolveActivationModerationAccounts({
259
+ rpcUrl: ctx.rpcUrl,
260
+ task: taskPda,
261
+ jobSpecHash,
262
+ moderator: activationModerator,
263
+ });
208
264
  const activationResult = await client.setTaskJobSpec({
209
265
  ...(input.activation ?? {}),
210
- ...(moderationAttestor !== undefined ? { moderationAttestor } : {}),
266
+ ...activationModerationArgs,
211
267
  task: taskPda,
212
268
  creator,
213
269
  jobSpecHash,
214
270
  jobSpecUri,
271
+ moderator: activationModerator,
215
272
  } as Parameters<typeof facadeNs.setTaskJobSpec>[0]);
216
273
 
217
274
  const result: HumanlessHireFlowResult = {
@@ -7,7 +7,7 @@ import {
7
7
  requireClient,
8
8
  type MutationStatus,
9
9
  } from "./internal.js";
10
- import { resolveActivationModerationAttestor } from "./moderation-attestor.js";
10
+ import { resolveActivationModerationAccounts } from "./moderation-attestor.js";
11
11
 
12
12
  export type TaskActivationInput = Omit<
13
13
  Parameters<typeof facadeNs.setTaskJobSpec>[0],
@@ -34,20 +34,26 @@ export function useTaskActivation(
34
34
  const mutation = useMutation<string, Error, TaskActivationInput>({
35
35
  mutationFn: async (input) => {
36
36
  const client = requireClient(ctx.client);
37
- // WP-A1: when the task moderation was authored by a roster attestor
38
- // (not the global authority), the publish gate only unlocks if the
39
- // attestor's roster-entry PDA is attached. Resolve it automatically
40
- // unless the caller supplied one.
41
- const moderationAttestor =
42
- input.moderationAttestor ??
43
- (await resolveActivationModerationAttestor({
44
- rpcUrl: ctx.rpcUrl,
45
- task: taskPda,
46
- jobSpecHash: input.jobSpecHash,
47
- }));
37
+ // P1.2: the publish gate names an explicit `moderator` (supplied by the
38
+ // caller — the trust decision) and needs the roster-entry PDA when that
39
+ // moderator is a registered attestor, plus a record override when the
40
+ // attestation predates the upgrade (legacy grace window). Resolve the
41
+ // mechanics automatically unless the caller supplied any of them.
42
+ const callerResolved =
43
+ input.moderationAttestor !== undefined ||
44
+ input.moderatorIsAttestor !== undefined ||
45
+ input.taskModeration !== undefined;
46
+ const resolved = callerResolved
47
+ ? {}
48
+ : await resolveActivationModerationAccounts({
49
+ rpcUrl: ctx.rpcUrl,
50
+ task: taskPda,
51
+ jobSpecHash: input.jobSpecHash,
52
+ moderator: input.moderator,
53
+ });
48
54
  const { signature } = await client.setTaskJobSpec({
49
55
  ...input,
50
- ...(moderationAttestor !== undefined ? { moderationAttestor } : {}),
56
+ ...resolved,
51
57
  task: taskPda,
52
58
  creator: input.creator ?? client.signer,
53
59
  } as Parameters<typeof facadeNs.setTaskJobSpec>[0]);
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/provider/context.ts","../src/hooks/internal.ts","../src/hooks/useHire.ts","../src/hooks/useWalletSigner.ts"],"names":["useCallback"],"mappings":"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","file":"chunk-2Y6JN2VZ.js","sourcesContent":["/**\n * The React context object + the internal `useAgencContext()` hook.\n *\n * Split from the component file so the context identity is stable and so hooks\n * can import the context without pulling the JSX provider into their module\n * graph. SSR-safe: this module only calls `createContext` at import time, never\n * touches `window`.\n *\n * @module provider/context\n */\nimport { createContext, useContext } from \"react\";\nimport { t } from \"../strings/index.js\";\nimport type { AgencContextValue } from \"../types.js\";\n\n/**\n * The AgenC context. `null` until a `<AgencProvider>` mounts above the consumer\n * — {@link useAgencContext} turns that into a clear developer error.\n */\nexport const AgencContext = createContext<AgencContextValue | null>(null);\nAgencContext.displayName = \"AgencContext\";\n\n/**\n * Read the AgenC context. INTERNAL hook the package's own hooks build on; also\n * exported from the package root so downstream hooks (components agent) can\n * reach the resolved transport/client/referrer.\n *\n * @throws Error when called outside a `<AgencProvider>`.\n */\nexport function useAgencContext(): AgencContextValue {\n const ctx = useContext(AgencContext);\n if (ctx === null) {\n throw new Error(t(\"provider.missingContext\"));\n }\n return ctx;\n}\n","/**\n * Internal helpers shared by the headless hooks.\n *\n * - A namespaced TanStack Query key factory so every hook's cache entries are\n * stable, collision-free, and individually invalidatable.\n * - Tiny guards that turn a missing write client / signer into a clear,\n * catalog-routed error (never a `null.method()` crash) BEFORE a mutation runs.\n *\n * SSR-safe: pure functions, no `window`/`document`, no module-scope side\n * effects.\n *\n * @module hooks/internal\n */\nimport { t } from \"../strings/index.js\";\nimport type {\n Address,\n AgencContextValue,\n MarketplaceClient,\n TransactionSigner,\n} from \"../types.js\";\n\n/** Root namespace for every cache key this package writes. */\nexport const QUERY_KEY_ROOT = \"agenc\" as const;\n\n/**\n * Stable, hierarchical TanStack Query keys. Hooks build their keys ONLY through\n * this factory so a consumer (or a hook) can invalidate a whole sub-tree\n * (`[\"agenc\", \"listings\"]`) or one entity (`[\"agenc\", \"listing\", pda]`).\n *\n * `JSON.stringify` is intentionally NOT used — TanStack compares keys\n * structurally, so passing the raw filter object keeps equality correct for\n * `bigint`/`Address` values without a serialization step.\n */\nexport const queryKeys = {\n /** All listings list queries (with their filter object as the leaf). */\n listings: (filter?: unknown) =>\n [QUERY_KEY_ROOT, \"listings\", filter ?? null] as const,\n /** One listing + its joined provider/track-record/moderation. */\n listing: (pda: string) => [QUERY_KEY_ROOT, \"listing\", pda] as const,\n /** One agent's indexer track record. */\n agentTrackRecord: (agentPda: string) =>\n [QUERY_KEY_ROOT, \"agentTrackRecord\", agentPda] as const,\n /** One task's status (read via transport / svm decode). */\n taskStatus: (taskPda: string) =>\n [QUERY_KEY_ROOT, \"taskStatus\", taskPda] as const,\n /** One task's dispute record. */\n dispute: (taskPda: string) => [QUERY_KEY_ROOT, \"dispute\", taskPda] as const,\n /** One referrer wallet's earnings (indexer-gated; see useReferrerEarnings). */\n referrerEarnings: (wallet: string) =>\n [QUERY_KEY_ROOT, \"referrerEarnings\", wallet] as const,\n} as const;\n\n/**\n * Assert a write client exists, returning it narrowed to non-null. Throws a\n * clear, catalog-routed error when the provider was configured read-only (no\n * `client` and no resolvable `rpcUrl` + `signer`).\n *\n * Mutating hooks call this at the top of their `mutationFn` so the failure is a\n * descriptive Error in the mutation's `error` channel — never a crash.\n *\n * @throws Error (`provider.missingWriteClient`) when `client` is null.\n */\nexport function requireClient(\n client: MarketplaceClient | null,\n): MarketplaceClient {\n if (client === null) {\n throw new Error(t(\"provider.missingWriteClient\"));\n }\n return client;\n}\n\nexport type MutationStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport function mutationStatusOf(mutation: {\n isPending: boolean;\n isError: boolean;\n isSuccess: boolean;\n}): MutationStatus {\n if (mutation.isPending) return \"pending\";\n if (mutation.isError) return \"error\";\n if (mutation.isSuccess) return \"success\";\n return \"idle\";\n}\n\n/** Coerce an `Address | string` to its string form for use as a cache key. */\nexport function pdaKey(pda: Address | string): string {\n return String(pda);\n}\n\nexport interface ReferrerArgs {\n referrer?: Address;\n referrerFeeBps?: number;\n}\n\nexport interface ResolvedReferrerArgs {\n referrerArgs: ReferrerArgs;\n referrerInjected: boolean;\n}\n\nexport function resolveReferrerArgs(\n ctx: Pick<AgencContextValue, \"resolveReferrerCapability\">,\n): ResolvedReferrerArgs {\n const capability = ctx.resolveReferrerCapability();\n if (!capability.live || !capability.referrer) {\n return { referrerArgs: {}, referrerInjected: false };\n }\n return {\n referrerArgs: {\n referrer: capability.referrer.wallet,\n referrerFeeBps: capability.referrer.feeBps,\n },\n referrerInjected: true,\n };\n}\n\nexport type SignerOrAddress = TransactionSigner | Address;\n\nexport function signerAddress(signerOrAddress: SignerOrAddress): Address {\n if (typeof signerOrAddress === \"string\") {\n return signerOrAddress;\n }\n if (\n typeof signerOrAddress === \"object\" &&\n signerOrAddress !== null &&\n \"address\" in signerOrAddress &&\n typeof signerOrAddress.address === \"string\"\n ) {\n return signerOrAddress.address;\n }\n throw new Error(\"Expected a TransactionSigner or Address with an address field.\");\n}\n\nexport function withoutReferrerArgs<T extends object>(\n input: T,\n): Omit<T, \"referrer\" | \"referrerFeeBps\"> {\n const {\n referrer: _referrer,\n referrerFeeBps: _referrerFeeBps,\n ...rest\n } = input as T & { referrer?: unknown; referrerFeeBps?: unknown };\n return rest;\n}\n","/**\n * `useHire()` — the hire mutation hook (the embeddable money path).\n *\n * Drives `client.hireFromListing(...)` through the provider's write client and\n * surfaces the resulting transaction signature + minted Task PDA. Typed\n * `AgencError`s from the runtime client are surfaced UNTOUCHED in `error`.\n *\n * ## REFERRER SETTLEMENT\n *\n * The full 84-instruction protocol supports a demand-side referrer leg. This hook:\n * - reads `resolveReferrerCapability()` from context BEFORE building the hire;\n * - when `live === true`, spreads the validated provider referrer into the hire\n * input for both standard and humanless hires;\n * - the `referrerInjected` flag in the result is the audit signal. We never set\n * it true unless the transaction input included the referrer fields.\n *\n * @module hooks/useHire\n */\nimport { useMutation } from \"@tanstack/react-query\";\nimport { useCallback, useMemo } from \"react\";\nimport { findTaskPda } from \"@tetsuo-ai/marketplace-sdk\";\nimport type { facade as facadeNs } from \"@tetsuo-ai/marketplace-sdk\";\nimport { useAgencContext } from \"../provider/context.js\";\nimport type { Address } from \"../types.js\";\nimport {\n requireClient,\n resolveReferrerArgs,\n signerAddress,\n withoutReferrerArgs,\n} from \"./internal.js\";\n\n/**\n * Input to a standard `hire(...)` — a buyer that has a registered marketplace\n * agent (`creatorAgent`). This task settles on the HIRE COMPLETION path (the\n * worker calls `complete_task`). This is the SDK `facade.hireFromListing` input\n * MINUS the fee-payer signers, which default to the provider's write-client\n * signer (authority == creator == buyer). Pass them only to override.\n *\n * NOTE: deliberately NO referrer field — the referrer is provider-level config\n * and is injected only when `resolveReferrerCapability()` is live.\n */\nexport type HireInput = Omit<\n Parameters<typeof facadeNs.hireFromListing>[0],\n \"authority\" | \"creator\" | \"referrer\" | \"referrerFeeBps\"\n> & {\n /** Standard hire (default). */\n humanless?: false;\n /** Override the buyer authority signer (defaults to the client signer). */\n authority?: Parameters<typeof facadeNs.hireFromListing>[0][\"authority\"];\n /** Override the buyer/creator signer (defaults to the client signer). */\n creator?: Parameters<typeof facadeNs.hireFromListing>[0][\"creator\"];\n};\n\n/**\n * Input to a HUMANLESS `hire(...)` — a plain-wallet buyer with NO registered\n * agent (the storefront-visitor path). The task is pinned to CreatorReview, so\n * it settles via the BUYER REVIEW path (`useSubmissionReview` accept/reject) —\n * the human reviews before funds release. This is the SDK\n * `facade.hireFromListingHumanless` input minus the `creator` signer (defaulted\n * to the client signer).\n */\nexport type HumanlessHireInput = Omit<\n Parameters<typeof facadeNs.hireFromListingHumanless>[0],\n \"creator\" | \"referrer\" | \"referrerFeeBps\"\n> & {\n /** Discriminates the humanless storefront-visitor hire. */\n humanless: true;\n /** Override the buyer/creator signer (defaults to the client signer). */\n creator?: Parameters<typeof facadeNs.hireFromListingHumanless>[0][\"creator\"];\n};\n\n/** The union of standard and humanless hire inputs. */\nexport type AnyHireInput = HireInput | HumanlessHireInput;\n\n/** Lifecycle status of the hire mutation. */\nexport type HireStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\n/** Result of a settled hire. */\nexport interface HireResult {\n /** The confirmed transaction signature. */\n signature: string;\n /** The minted Task PDA (derived from creator + taskId). */\n taskPda: Address;\n /**\n * Whether a referrer fee leg was injected into THIS hire. Audit signal —\n * never fabricated.\n */\n referrerInjected: boolean;\n}\n\n/** Return value of {@link useHire}. */\nexport interface UseHireResult {\n /** Execute a hire. Resolves to {@link HireResult}; rejects with `AgencError`. */\n hire: (input: AnyHireInput) => Promise<HireResult>;\n /** Current mutation status. */\n status: HireStatus;\n /** The minted Task PDA from the last successful hire, or null. */\n taskPda: Address | null;\n /** The signature from the last successful hire, or null. */\n signature: string | null;\n /** The error from the last hire (typed `AgencError` untouched), or null. */\n error: Error | null;\n /** Whether a hire is currently in flight. */\n isPending: boolean;\n /** Reset the mutation back to idle. */\n reset: () => void;\n}\n\n/**\n * The hire hook.\n *\n * @returns {@link UseHireResult}.\n *\n * @example\n * ```tsx\n * const { hire, status, taskPda, error } = useHire();\n * await hire({\n * listing, creatorAgent, taskId, expectedPrice: price, expectedVersion: 1n,\n * listingSpecHash,\n * });\n * ```\n */\nexport function useHire(): UseHireResult {\n const ctx = useAgencContext();\n\n const mutation = useMutation<HireResult, Error, AnyHireInput>({\n mutationFn: async (input: AnyHireInput): Promise<HireResult> => {\n const client = requireClient(ctx.client);\n\n // Resolve fresh per hire so a provider referrer config change cannot leak\n // stale referral terms into a new transaction.\n const { referrerArgs, referrerInjected } = resolveReferrerArgs(ctx);\n const hireInput = withoutReferrerArgs(input);\n\n const creator = input.creator ?? client.signer;\n let signature: string;\n\n if (input.humanless === true) {\n // Storefront-visitor hire: no creator agent; CreatorReview-pinned, so\n // it settles via the buyer review path (useSubmissionReview).\n const result = await client.hireFromListingHumanless({\n ...hireInput,\n creator,\n ...referrerArgs,\n } as Parameters<typeof facadeNs.hireFromListingHumanless>[0]);\n signature = result.signature;\n } else {\n // Standard hire: authority == creator == buyer (the buyer has an agent).\n const authority = input.authority ?? client.signer;\n const result = await client.hireFromListing({\n ...hireInput,\n authority,\n creator,\n ...referrerArgs,\n } as Parameters<typeof facadeNs.hireFromListing>[0]);\n signature = result.signature;\n }\n\n // Derive the minted Task PDA from (creator, taskId).\n const [taskPda] = await findTaskPda({\n creator: signerAddress(creator),\n taskId: input.taskId,\n });\n\n return { signature, taskPda, referrerInjected };\n },\n });\n\n const hire = useCallback(\n (input: AnyHireInput) => mutation.mutateAsync(input),\n [mutation],\n );\n\n const status: HireStatus = useMemo(() => {\n if (mutation.isPending) return \"pending\";\n if (mutation.isError) return \"error\";\n if (mutation.isSuccess) return \"success\";\n return \"idle\";\n }, [mutation.isPending, mutation.isError, mutation.isSuccess]);\n\n return {\n hire,\n status,\n taskPda: mutation.data?.taskPda ?? null,\n signature: mutation.data?.signature ?? null,\n error: mutation.error ?? null,\n isPending: mutation.isPending,\n reset: mutation.reset,\n };\n}\n","/**\n * `useWalletSigner()` — bridges a browser wallet into the kit `TransactionSigner`\n * the SDK write client expects.\n *\n * ## Adapter seam (the signer-adapters package is not built yet)\n *\n * The dedicated `@tetsuo-ai/signer-adapters` package (the signers agent, PLAN.md\n * P4.1) — which wraps `@solana/react`'s\n * `useWalletAccountTransactionSendingSigner` (Wallet Standard) and the legacy\n * `@solana/wallet-adapter` shim into a kit `TransactionSigner` — does not exist\n * at this hook's build time. So this hook is defined against a **documented\n * adapter interface** ({@link WalletSignerAdapter}) rather than importing that\n * package. A caller passes an adapter (today: a thin wrapper they write, or the\n * signer-adapters hook once it ships) and this hook normalizes it to the\n * `{ signer, connected, connect() }` contract every other hook expects.\n *\n * With NO adapter passed, the hook falls back to the provider's configured\n * `signer` (the `AgencProvider config.signer` slot), so a server-supplied or\n * test signer just works and `connect()` is a no-op.\n *\n * SSR-safe: no `window`/`document`; the adapter (which may touch wallet globals)\n * is the caller's responsibility to gate to the client. This hook only reads\n * what the adapter already resolved.\n *\n * @module hooks/useWalletSigner\n */\nimport { useCallback } from \"react\";\nimport { useAgencContext } from \"../provider/context.js\";\nimport type { TransactionSigner } from \"../types.js\";\n\n/**\n * The minimal adapter shape this hook bridges. The forthcoming\n * `@tetsuo-ai/signer-adapters` hook is expected to return exactly this shape\n * (its `signerFromWalletAccount(...)` resolves the `signer`); until it ships,\n * any object matching this interface works.\n */\nexport interface WalletSignerAdapter {\n /** The resolved kit signer, or null when no wallet is connected. */\n signer: TransactionSigner | null;\n /** Whether a wallet is currently connected. */\n connected?: boolean;\n /** Trigger the wallet connect flow (browser-only). Optional. */\n connect?: () => void | Promise<void>;\n}\n\n/** Options for {@link useWalletSigner}. */\nexport interface UseWalletSignerOptions {\n /**\n * A wallet adapter (e.g. the signer-adapters hook's result). When omitted the\n * hook falls back to the provider's `config.signer`.\n */\n adapter?: WalletSignerAdapter;\n}\n\n/** Return value of {@link useWalletSigner}. */\nexport interface UseWalletSignerResult {\n /** The resolved kit `TransactionSigner`, or null. */\n signer: TransactionSigner | null;\n /** Whether a signer is available (adapter-connected or provider-configured). */\n connected: boolean;\n /** Trigger the wallet connect flow. No-op when no adapter `connect` exists. */\n connect: () => void | Promise<void>;\n}\n\n/**\n * Resolve the active signer for write operations.\n *\n * @param options - Optional wallet adapter; falls back to the provider signer.\n * @returns {@link UseWalletSignerResult}.\n *\n * @example\n * ```tsx\n * // Once @tetsuo-ai/signer-adapters ships:\n * const adapter = useWalletStandardSigner(); // returns WalletSignerAdapter\n * const { signer, connected, connect } = useWalletSigner({ adapter });\n * ```\n */\nexport function useWalletSigner(\n options?: UseWalletSignerOptions,\n): UseWalletSignerResult {\n const ctx = useAgencContext();\n const adapter = options?.adapter;\n\n // Adapter wins when present; otherwise the provider's configured signer.\n const signer: TransactionSigner | null =\n adapter?.signer ?? ctx.signer ?? null;\n const connected =\n adapter !== undefined\n ? (adapter.connected ?? adapter.signer !== null)\n : ctx.signer !== null;\n\n const connect = useCallback(() => {\n // No adapter (or no connect on it) => provider-supplied signer is already\n // \"connected\"; connecting is a no-op rather than an error.\n return adapter?.connect ? adapter.connect() : undefined;\n }, [adapter]);\n\n return { signer, connected, connect };\n}\n"]}