feat: add payroll feature

[JoelVR17]

Pull Request | Trustless Work

1. Issue Link

• Closes #(issue number)

---

2. Brief Description of the Issue

---

3. Type of Change

Mark with an x all the checkboxes that apply (like [x]).

• 📝 Documentation (updates to README, docs, or comments)
• 🐛 Bug fix (non-breaking change which fixes an issue)
• 👌 Enhancement (non-breaking change which adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to change)

---

4. Changes Made

• Change 1
• Change 2
• Change 3

---

5. Evidence Before Solution

Loom Video - Before Solution

---

6. Evidence After Solution

Loom Video - After Solution

---

7. Important Notes

• Note 1
• Note 2
• Note 3

If you don't use this template, you'd be ignored

Summary by CodeRabbit

• New Features

  • Added an admin Payroll area for creating, viewing, funding, and paying payroll runs, with salary and test payment tabs.
  • Added payroll period selection, member management, payment status tracking, and options to share payment summaries or view runs in Stellar explorers.
  • Added payroll navigation and wallet controls to the admin experience.
  • Added clearer truncation for long addresses and improved responsive tab indicators.

• Bug Fixes

  • Improved admin session handling to prevent unintended sign-outs.
  • Improved escrow engagement ID display and payroll payment details.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
d-app-trustless-work	Ready	Preview	Sep 25, 2026 6:34am UTC
trustlesswork-backoffice	Ready	Preview	Sep 25, 2026 6:34am UTC

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 783f14da-3877-401a-8be8-8e12e1d4b839

📥 Commits

Reviewing files that changed from the base of the PR and between dcfe985 and d051a31.

📒 Files selected for processing (54)

• src/app/admin/(protected)/payroll/[contractId]/page.tsx
• src/app/admin/(protected)/payroll/page.tsx
• src/app/api/admin/payroll/core/[...path]/route.ts
• src/components/shared/Breadcrumb.tsx
• src/components/shared/ResponsiveCopyField.tsx
• src/components/ui/badge.tsx
• src/components/ui/custom-tab.tsx
• src/constants/navigation.ts
• src/constants/pages.ts
• src/features/admin-auth/ui/AdminNavbar.tsx
• src/features/auth/hooks/useSession.ts
• src/features/auth/lib/logout-client.test.ts
• src/features/auth/lib/logout-client.ts
• src/features/escrows/ui/EscrowDetailView.tsx
• src/features/escrows/ui/detail/EscrowDetailHeader.tsx
• src/features/escrows/utils/escrow-rest-map.helper.test.ts
• src/features/escrows/utils/escrow-rest-map.helper.ts
• src/features/payroll/constants/payment-tabs.ts
• src/features/payroll/constants/payroll.constants.ts
• src/features/payroll/constants/team.constants.test.ts
• src/features/payroll/constants/team.constants.ts
• src/features/payroll/hooks/usePayrollRunForm.ts
• src/features/payroll/hooks/usePayrollRuns.ts
• src/features/payroll/schemas/payroll-run.schema.ts
• src/features/payroll/ui/NewPayrollRunDialog.tsx
• src/features/payroll/ui/PayrollExplorerLinks.tsx
• src/features/payroll/ui/PayrollFundAction.tsx
• src/features/payroll/ui/PayrollMembersList.tsx
• src/features/payroll/ui/PayrollMembersPanel.tsx
• src/features/payroll/ui/PayrollPayAction.tsx
• src/features/payroll/ui/PayrollPeriodPicker.tsx
• src/features/payroll/ui/PayrollRunDetail.tsx
• src/features/payroll/ui/PayrollRunsList.tsx
• src/features/payroll/ui/PayrollShareAction.tsx
• src/features/payroll/ui/PayrollView.tsx
• src/features/payroll/utils/payroll-form.helper.ts
• src/features/payroll/utils/payroll-members.helper.ts
• src/features/payroll/utils/payroll-naming.helper.test.ts
• src/features/payroll/utils/payroll-naming.helper.ts
• src/features/payroll/utils/payroll-payload.helper.test.ts
• src/features/payroll/utils/payroll-payload.helper.ts
• src/features/payroll/utils/payroll-share-image.helper.test.ts
• src/features/payroll/utils/payroll-share-image.helper.ts
• src/lib/env/classes/api-env.ts
• src/lib/env/classes/client-env.ts
• src/lib/env/classes/payroll-env.ts
• src/lib/env/client-env-schema.ts
• src/lib/env/server-env-schema.ts
• src/lib/http.ts
• src/lib/payroll-fetch.test.ts
• src/lib/payroll-fetch.ts
• src/providers/AdminTrustlessWorkProvider.tsx
• src/providers/TrustlessWorkConfigShell.tsx
• src/providers/TrustlessWorkProvider.tsx

 ____________________________________________________________
< To iterate is human, to recurse divine. - L. Peter Deutsch >
 ------------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       / 　 づ

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}