👨‍💻 User Story

As a Web3 experience architect I want to create streamlined and user experience optimized transaction flows.

More specifically I want to integrate the Delegatable framework and gas-less subscription services into my Web3 application.

📜 Disclaimer

To be eligible for the payout you must first get approval to work on the bounty.

• Join the ⚡️TurboETH Discord channel
• Introduce yourself in the general channel
• Announce your interest in the bounty channel

It's recommended to share a link to your personal Github account.

🧱 Project

Integrate the delegatable smart contract framework into a TurboETH template.

Integrate the DistrictERC20PermitSubscriptionsEnforcer enforcer smart contract.

Delegatable using rather complex EIP712 signatures to embed transaction execution conditionals directly into a transaction signature.

It's recommended to review the DistrictERC20PermitSubscriptionsEnforcer unit tests to see how implement the terms bytecode packing.

Options
You can fork the Gifte Cards template and add the integration in the template.

• Code - https://github.com/McOso/giftee
• Demo - https://www.giftee.cards

This will require removing the existing functionality or adding the subscription functionality to the existing user interface.

Or...

Create an integration/streaming-delegatable integration in the TurboETH integrations branch and expose the funcionality in the integrations section.

Either way it's recommended to review the Giftee Cards application to see how delegatable is integrated. The EIP712 signatures can be tricky.

Required Functionality:

• Start gas-less subscription and save transaction in a database.
• Revoke subscription delegation.
• Vercel cron job function every 30 minutes to execute valid transactions.

Developer Tasks:

• Add essential Delegatable V0 smart contract artifacts
  • delegatable-abi.json and delegatable-bytecode.json
  • district-erc20-permit-subscriptions-enforcer-abi.json and district-erc20-permit-subscriptions-enforcer-bytecode.json
• Create wagmi.config.js - Configure to use essential smart contract artifacts
• Create Component - form-subscription-start.tsx
• Create Component - form-subscription-end.tsx

Potential File Structure

Integration

The core delegatable-subscription integration should be added to the integrations/delegatable-subscription folder.

integrations/delegatable-subscription
├─ components/
│  ├─ form-delegatable-subscription-start.tsx
│  ├─ form-delegatable-subscription-revoke.tsx
├─ hooks/
│  ├─ **/*.ts
├─ utils/
│  ├─ **/*.ts
├─ delegatable-wagmi.ts
├─ delegatable-enforcers-wagmi.ts
├─ wagmi.config.ts
├─ README.md

Application

The subscription pages should be added to the app/delegatable folder.

app/delegatable
├─ subscription
│  ├─ page.tsx

Resources

Delegatable is a complex smart contract solidity framework. It handles transaction formatting and execution differently, compared to a standard transaction or meta-transaction.

Below is an example of delegatable transaction object.

const INVOCATION_MESSAGE = {
      replayProtection: {
        nonce: '0x01',
        queue: '0x00',
      },
      batch: [
        {
          authority: [],
          transaction: {
            to: verifyingContract.address,
            gasLimit: '210000000000000000',
            data: (
              await verifyingContract.populateTransaction.approveSubscription(
                wallet0.address,
                totalSubscriptionAmount,
                deadline,
                v,
                r,
                s,
              )
            ).data,
          },
        },
        {
          authority: [_delegation],
          transaction: {
            to: verifyingContract.address,
            gasLimit: '210000000000000000',
            data: (await verifyingContract.populateTransaction.paySubscription()).data,
          },
        },
      ],
    };

💰 Bounty Reward

The bounty reward is 325 OP tokens and TurboETH DevPass digital collectible.

TurboETH is the recipient of 18,271.88 OP Tokens from Optimism Retroactive Public Goods Funding. The OP tokens earned from the PGF program are the primary funding source for TurboETH bounties.

Notice

The final integration may not resemble the proposed integration - that's O.K - a natural part of software development.

During development you might discover an original hypothesis doesn't make sense. No problem. Make a comment and clearly explain why a new approach is better than old one. Get rewarded for thinking out of the box.

The final bounty reward can be increased to match new bounty tasks.

Resources

• ⚡️ TurboETH
  • Overview - http://docs.turboeth.xyz
• 🎛️ Delegatable
  • Documentation - https://delegatable.org/g
  • Solidity - https://github.com/delegatable/delegatable-sol