🔄 synced local 'src/' with remote 'src/'

src/app.ts

@@ -30,7 +30,8 @@ import {
   tokens as tokensRouter,
   wallets as walletsRouter,
   transactions as transactionsRouter,
-  authTransRouter
+  authTransRouter,
+  faucet as faucetRouter
 } from './routers';
 
 export const app: Express = express();
@@ -91,6 +92,7 @@ app.use('/users', usersRouter, authUserRouter);
 app.use('/tokens', tokensRouter);
 app.use('/wallets', authMiddleware, walletsRouter);
 app.use('/transactions', transactionsRouter, authTransRouter);
+app.use('/faucet', authMiddleware, faucetRouter);
 
 // Error handling
 app.use(errorHandler);

src/controllers/faucet.ts

@@ -0,0 +1,36 @@
+// Copyright (c) 2024, Circle Technologies, LLC. All rights reserved.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { NextFunction, Request, Response } from 'express';
+import { circleUserSdk } from '../services';
+
+export const dripFaucet = async (
+  req: Request,
+  res: Response,
+  next: NextFunction
+) => {
+  try {
+    await circleUserSdk.requestTestnetTokens({
+      address: req.body.address,
+      blockchain: req.body.blockchain,
+      usdc: true
+    });
+
+    res.status(200).send();
+  } catch (error: unknown) {
+    next(error);
+  }
+};

src/controllers/index.ts

@@ -19,3 +19,4 @@ export * from './onboarding';
 export * from './wallets';
 export * from './transactions';
 export * from './tokens';
+export * from './faucet';

src/controllers/onboarding.ts

@@ -85,6 +85,7 @@ export const signInCallback = (req: Request, res: Response) =>
         res.sendStatus(401);
         return;
       }
+
       // valid credentials
       const tokenResponse = await circleUserSdk.createUserToken({
         userId: user.userId

src/middleware/types/schemas.ts

@@ -198,3 +198,14 @@ export const getTokenDetailsSchema = yup.object({
     .noUnknown(true)
     .strict()
 });
+
+// Faucet
+export const postFaucetDripSchema = yup.object({
+  body: yup
+    .object({
+      address: yup.string().required(),
+      blockchain: yup.string().required()
+    })
+    .noUnknown(true)
+    .strict()
+});

src/routers/faucet.ts

@@ -0,0 +1,36 @@
+// Copyright (c) 2024, Circle Technologies, LLC. All rights reserved.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import express from 'express';
+import { postFaucetDripSchema, validate } from '../middleware';
+import { dripFaucet } from '../controllers';
+
+const faucet = express.Router();
+
+/**
+ * POST - /faucet/drips
+ * Request testnet tokens to specified wallet.
+ *
+ * Params:
+ *  address: string         - Wallet address
+ *  blockchain: string      - Specified blockchain
+ *
+ * Returns: null
+ *
+ */
+faucet.post('/drips', validate(postFaucetDripSchema), dripFaucet);
+
+export { faucet };

src/routers/index.ts

@@ -18,3 +18,4 @@ export * from './transactions';
 export * from './wallets';
 export * from './tokens';
 export * from './users';
+export * from './faucet';