@seedprotocol/publish 0.4.31 → 0.5.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.5.0
+
+### Breaking
+
+- **Thirdweb is optional.** Core `@seedprotocol/publish` no longer re-exports Thirdweb helpers, `ConnectButton`, or Thirdweb-backed wallet bootstrap APIs. Import them from **`@seedprotocol/publish/thirdweb`**.
+- **`PublishConfig.thirdwebClientId`** is optional. When unset, **`rpcUrl`** is required.
+- **`SeedSigner`** no longer includes `sendTransaction`. Use **`SeedTxSender`** / **`PublishWallet`** (`{ signer, txSender }`). Wrap Thirdweb Accounts with **`fromThirdwebAccount`** from the `/thirdweb` entry.
+- Core **`PublishProvider`** no longer wraps **`ThirdwebProvider`**. Use `@seedprotocol/publish/thirdweb`’s `PublishProvider` for ConnectButton apps.
+
+### Added
+
+- **`SeedTxSender`**, **`PublishWallet`**, **`fromEthersWallet`** (returns `PublishWallet`), **`fromEip1193Provider`**, **`useSeedWallet`**, **`setPublishWallet` / `getPublishWallet`**.
+- **`ensureWalletThenPublish`** for vendor-neutral publish entry (registry wallet + optional permissionless EIP-7702).
+- **`createPermissionlessTxSender`** (permissionless `to7702SimpleSmartAccount`) with config fields **`bundlerUrl`**, **`paymasterUrl`**, **`accountMode`**, **`chain`**, **`rpcUrl`**.
+
 ## 0.4.31
 
 ### Fixed

package/README.md

@@ -10,38 +10,77 @@ The publish flow (ConnectButton, etc.) runs `ensureEasSchemasForItem` before `ge
 
 ## Setup
 
-Wrap your app with `PublishProvider`. The provider includes:
+`uploadApiBaseUrl` is required. Provide either `rpcUrl` or `thirdwebClientId` (RPC falls back to Thirdweb’s edge when only the client id is set).
 
-- Thirdweb's required context (React Query, connection manager)
-- SeedProvider (React Query for Seed SDK hooks like `useItems`, `useModels`, `useSchemas`)
+Thirdweb is an **optional** peer. Core publish uses `SeedSigner` + `SeedTxSender` (`PublishWallet`). Import ConnectButton / in-app wallets from `@seedprotocol/publish/thirdweb`.
 
-You can optionally pass `queryClient` or `queryClientRef` to customize the Seed QueryClient.
-
-`thirdwebClientId` and `uploadApiBaseUrl` are required in config. Other values (account factory, EAS contract) are defined as constants in the package.
+### Recipe 1: EIP-1193 + EOA (no Thirdweb)
 
-### Option A: Config via provider
+User pays gas. Works with MetaMask / injected wallets.
 
 ```tsx
-import { PublishProvider, ConnectButton } from '@seedprotocol/publish'
+import {
+  PublishProvider,
+  useSeedWallet,
+  ensureWalletThenPublish,
+  initPublish,
+} from '@seedprotocol/publish'
+import { optimismSepolia } from 'viem/chains'
 
-function App() {
+initPublish({
+  uploadApiBaseUrl: import.meta.env.VITE_UPLOAD_API_BASE_URL,
+  rpcUrl: import.meta.env.VITE_RPC_URL,
+  chain: optimismSepolia,
+  accountMode: 'eoa',
+})
+
+function Connect() {
+  const { status, connect, address } = useSeedWallet()
   return (
-    <PublishProvider
-      config={{
-        thirdwebClientId: import.meta.env.VITE_THIRDWEB_CLIENT_ID,
-        uploadApiBaseUrl: import.meta.env.VITE_UPLOAD_API_BASE_URL,
-      }}
+    <button
+      onClick={() => connect((window as any).ethereum)}
+      disabled={status === 'connecting'}
     >
-      <ConnectButton />
+      {address ?? 'Connect wallet'}
+    </button>
+  )
+}
+
+function App() {
+  return (
+    <PublishProvider>
+      <Connect />
     </PublishProvider>
   )
 }
+
+// Later:
+// await ensureWalletThenPublish(item, { dataItemSigner: /* from useSeedWallet().signer */ })
+```
+
+### Recipe 2: EIP-1193 + permissionless EIP-7702 (gasless, no Thirdweb)
+
+```tsx
+initPublish({
+  uploadApiBaseUrl: import.meta.env.VITE_UPLOAD_API_BASE_URL,
+  rpcUrl: import.meta.env.VITE_RPC_URL,
+  chain: optimismSepolia,
+  accountMode: 'eip7702',
+  bundlerUrl: import.meta.env.VITE_BUNDLER_URL,
+  paymasterUrl: import.meta.env.VITE_PAYMASTER_URL, // optional; defaults to bundlerUrl
+})
 ```
 
-### Option B: Config via initPublish
+`useSeedWallet().connect(provider)` upgrades the EOA sender to a permissionless EIP-7702 `SeedTxSender` when `accountMode` is `eip7702` and `bundlerUrl` is set. ModularCore / ManagedAccount session-key flows remain Thirdweb-only.
+
+### Recipe 3: Thirdweb ConnectButton (batteries-included)
 
 ```tsx
-import { PublishProvider, ConnectButton, initPublish } from '@seedprotocol/publish'
+import { initPublish } from '@seedprotocol/publish'
+import {
+  PublishProvider,
+  ConnectButton,
+} from '@seedprotocol/publish/thirdweb'
 
 initPublish({
   thirdwebClientId: import.meta.env.VITE_THIRDWEB_CLIENT_ID,
@@ -50,13 +89,20 @@ initPublish({
 
 function App() {
   return (
-    <PublishProvider>
+    <PublishProvider
+      config={{
+        thirdwebClientId: import.meta.env.VITE_THIRDWEB_CLIENT_ID,
+        uploadApiBaseUrl: import.meta.env.VITE_UPLOAD_API_BASE_URL,
+      }}
+    >
       <ConnectButton />
     </PublishProvider>
   )
 }
 ```
 
+You can optionally pass `queryClient` or `queryClientRef` to customize the Seed QueryClient.
+
 ### useIntegerLocalIds
 
 When using the new contract that expects `uint256` localIdIndex/publishLocalIdIndex instead of string localId/publishLocalId (gas-efficient), set `useIntegerLocalIds: true`: