@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/CHANGELOG.md +22 -0
- package/dist/{chunk-ZAMIL27X.js → chunk-BNILOX3O.js} +3 -3
- package/dist/{chunk-ZAMIL27X.js.map → chunk-BNILOX3O.js.map} +1 -1
- package/dist/{chunk-2Y6JN2VZ.js → chunk-BTAVED7S.js} +87 -4
- package/dist/chunk-BTAVED7S.js.map +1 -0
- package/dist/components/index.cjs +55 -0
- package/dist/components/index.cjs.map +1 -1
- package/dist/components/index.js +2 -2
- package/dist/hooks/index.cjs +117 -40
- package/dist/hooks/index.cjs.map +1 -1
- package/dist/hooks/index.d.cts +14 -1
- package/dist/hooks/index.d.ts +14 -1
- package/dist/hooks/index.js +38 -44
- package/dist/hooks/index.js.map +1 -1
- package/dist/index.cjs +54 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +3 -3
- package/package.json +2 -2
- package/src/hooks/moderation-attestor.ts +176 -57
- package/src/hooks/useHire.ts +27 -0
- package/src/hooks/useHumanlessHireFlow.ts +74 -17
- package/src/hooks/useTaskActivation.ts +19 -13
- package/dist/chunk-2Y6JN2VZ.js.map +0 -1
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-
|
|
5
|
-
import { AgencContext } from './chunk-
|
|
6
|
-
export { AgencContext, useAgencContext } from './chunk-
|
|
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
|
+
"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.
|
|
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
|
|
3
|
-
* activation (WP-A1).
|
|
2
|
+
* Resolve the P1.2 moderation accounts a consumption gate needs.
|
|
4
3
|
*
|
|
5
|
-
* Post-
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
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
|
-
*
|
|
15
|
-
* moderator
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
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
|
|
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
|
|
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
|
-
*
|
|
41
|
-
* `undefined` when
|
|
42
|
-
* moderation
|
|
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
|
|
47
|
-
*
|
|
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
|
|
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<
|
|
130
|
+
}): Promise<ActivationModerationAccounts> {
|
|
57
131
|
try {
|
|
58
|
-
const rpc =
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
|
70
|
-
|
|
71
|
-
|
|
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
|
-
|
|
90
|
-
|
|
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
|
-
|
|
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
|
|
95
|
-
|
|
96
|
-
return undefined;
|
|
214
|
+
// Degrade to "no overrides" — never block the flow on a read failure.
|
|
215
|
+
return {};
|
|
97
216
|
}
|
|
98
217
|
}
|
package/src/hooks/useHire.ts
CHANGED
|
@@ -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 {
|
|
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
|
-
): {
|
|
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
|
-
|
|
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 } =
|
|
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
|
-
//
|
|
199
|
-
//
|
|
200
|
-
//
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
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
|
-
...
|
|
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 {
|
|
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
|
-
//
|
|
38
|
-
//
|
|
39
|
-
// attestor
|
|
40
|
-
//
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
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
|
-
...
|
|
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"]}
|