Forem: Darlan Jr

Basic KYC Implementation Guide using KYC_CHECK

Darlan Jr — Tue, 22 Apr 2025 04:08:58 +0000

🔍 KYC Implementation Guide

📝 Introduction

KYC (Know Your Customer) is an essential process for verifying user identity and preventing fraud. In this article, we'll explore how to implement a basic KYC system using the KYC_CHECK library.

🎯 Main Validations

The system implements two main validations:

First Validation 👤: Verifies if the person is the actual owner of the presented document
Withdrawal Validation 💰: Verifies if it's the user attempting to make a significant withdrawal

🚀 Implementation for New Users

For new users, we perform the first validation:

Process 🔄: Comparison between the document sent and the First Selfie

🔄 Subsequent Validations

For future validations, we keep the user's most recent photo updated:

Process 📸: Comparison between Last Selfie and New Selfie
Monthly Validation 📅: If the user hasn't added a new photo within 1 month, a new validation will be required

💻 Implementation Example

Let's consider a scenario where a user wants to make a withdrawal greater than 70% of their balance and more than $100.

Note ℹ️: The $100 threshold is implemented to avoid unnecessary validations for small amounts. For example, it wouldn't make sense to request a new selfie to validate a $7 withdrawal from a $10 balance.

interface ValidationResult {
  isValid: boolean;
  message?: string;
}

function validateWithdrawal(amount: number, userBalance: number) {
    const percentageThreshold = 0.7; // 70%
    const amountThreshold = 10000; // $100

    if (userBalance > amountThreshold &&  amount > userBalance * amountThreshold ) {
        return performNewValidation();
    }
    return true;
}

🤖 Face Similarity Calculation

The face similarity is calculated using the Euclidean distance between facial descriptors. Here's how it works:

📊 Example Response:

{
  "threshold": 0.49,
  "rawDistance": 0.5034011876789618,
  "faceDetection1": {
    "score": 0.9882098436355591,
    "box": {
      "x": 95.0972925721421,
      "y": 76.55234995484352,
      "width": 124.7091704960397,
      "height": 140.45916613936424
    }
  },
  "faceDetection2": {
    "score": 0.9953930974006653,
    "box": {
      "x": 41.640078008340005,
      "y": 106.15492933988571,
      "width": 264.0857750636389,
      "height": 309.0272338986397
    }
  },
  "processingTimeMs": 291,
  "usingMockImplementation": false
}

🧮 Understanding the Calculation:

Euclidean Distance (rawDistance) 📏: 0.5034011876789618

This is the mathematical measure of the difference between facial descriptors
Values close to 0 indicate identical faces
Values close to 1 or higher indicate completely different faces

Similarity Calculation 🔢:

   similarity = 1 - euclideanDistance

In this case: 1 - 0.5034 ≈ 0.4966 (approximately 50%)

Percentage Conversion 📊:

   percentage = similarity * 100

In this case: 0.4966 * 100 ≈ 50%

Match Evaluation ✅:

The threshold is set to 0.49 (49%)
Since the similarity (50%) is greater than the threshold (49%), the faces are considered a match

The facial descriptors are 128-dimensional vectors that represent facial characteristics. The Euclidean distance measures the difference between these vectors in multidimensional space.

A value of 50% represents a borderline match - not a very strong match, but it's above the configured minimum threshold.

🎯 Final Considerations

Percentage and amount thresholds should be adjusted according to specific business rules
It's important to maintain a history of performed validations
Consider implementing a notification system for users during the validation process

Understand a Little More About Logical Reasoning

Darlan Jr — Sun, 02 Feb 2025 07:04:44 +0000

Logical Reasoning
- Deduction
- Induction
- Abduction
- Association
- Synthesis

Deduction

There are several ways to exercise logical reasoning. One of them, of great importance, is deduction. Perhaps you haven't noticed, but you practice deduction in the most everyday situations.

It is the ability to understand a general law to infer a particular event. For this, it is necessary to analyze a set of elements to define a particular proposition. It is very important to know how premises work.

Premises are the propositions or hypotheses used to form reasoning. For example, considering that everyone born in the state of São Paulo is a Paulista, is a premise. It is important to store this information, as it is the first step to perform deductive logical reasoning. Then, consider that every Brazilian is South American. This is another premise that stems from a general law that will not change. To perform the deduction, consider the two pieces of information: Paulistas are born in the state of São Paulo and all Brazilians are South American. Therefore, we can say that every Paulista is South American, as they are born in Brazil.

An important tip to develop your deductive reasoning is to observe the keywords present in the sentences and find the common law that governs them. The premises can be infinite, but the reasoning will only be assertive if they are true. Terms like "always," "all," "none," "some" will be recurrent in this type of statement.

Know that deduction is a development mechanism not only for everyday situations. It can be used in many cases of calculations, balances, and budgetary decisions. Therefore, use the tips proposed here and do not stop practicing.

Induction

Induction is another competence of logic and is related to the ability to understand a set of particular events to infer a universal pattern. It would be the inverse of deduction, and it is important to emphasize its hypothetical nature.

In induction, the premises also need to be true, but the conclusion has a probabilistic nature. Thus, inferences are made from the recurrence of isolated contexts. The inferences may or may not be true.

To understand how inductive reasoning works through inferences, consider, for example, a numerical sequence that behaves as follows: "2, 4, 6, 8, 10, ...". Following the established logic, one can consider that the next number will be 12, considering the presented sequence pattern. It is a probability that may occur, but since the sequence has not been finalized, it could be changed at any time.
Note that, due to its probabilistic nature, it is very common to consider induction as a statistical practice, but it is not a mathematical operation. Such competence is related to experimental sciences, that is, fundamentals based on experimentation. Therefore, the results obtained must be tested to reach a concrete conclusion.

An important tip for working on inductive reasoning is to clearly observe the patterns in which the premises are placed, and then reach a conclusion. Pay close attention to the events and their recurrences, analyzing the possibilities in which they can be worked.

Conclusion: Developing logic considering these particular events can help you exercise your critical thinking, in addition to guiding you for future actions. Continue practicing induction through activities that develop this critical thinking.

Suppose that at 12 pm a woman named Fernanda goes to the kitchen to drink water that is inside the refrigerator. She takes the water pitcher and pours it into a glass. At 7 pm, she does the same thing, taking the water pitcher from the refrigerator and pouring it into a glass to drink. The probability that every time she is thirsty, she will take the water pitcher from the refrigerator is high.

In induction, we make inferences from the recurrence of a situation and analyze the probability of it repeating in the same way every time it happens. Thus, inducing based on probability, the water will be from the refrigerator in all situations, being the most probable. This does not mean that taking water from the tap is not an option, but observing the presented patterns, the highest probability is to take water from the refrigerator. Observe these points whenever you are developing induction.

Abduction

It is very common when reading the word "abduction" to quickly associate it with the act of abducting, teleporting. However, in logic, abduction is more related to the ability to study facts and outline a theory to explain them.

In practice, such competence behaves from observation and hypothetical thinking. This means that it will be necessary to suppose a certain theory to explain a situation, that is, to create a more valid hypothesis to explain a phenomenon. For such a hypothesis to occur, it will be necessary to rely on your world knowledge.

Understand how it works: you know that water is capable of wetting objects, beings, and spaces. In addition, you know that every time it rains, the roof of your house gets wet. If you wake up on a certain day and see the roof of your house wet, you will automatically have the hypothetical thought of relating the situation to rain.
You can perceive that other situations could be put to explain the occurrence, but the most probable one is associated with your world knowledge and concrete observations that lead you to develop this reasoning.

Therefore, abductive reasoning will not be based on absolute truths, but rather on the most probable hypotheses to interpret and generate your truth.

An important tip for working on this competence is to consider the concrete knowledge you already have about a certain situation, as it will be of no use to create fanciful hypotheses for objective facts. Always seek to bring closer the most plausible and considerable justification according to the elements at your disposal.

Consider that the association of elements will be fundamental to developing logical reasoning. Therefore, it is necessary to increasingly expand your knowledge and exercise this practice that is so close to your daily life.

Association

You already know that to exercise logic, it is important to associate elements. Without this connection, logical reasoning cannot be successfully concluded, and much information is lost, leading to untrue developments.

Therefore, there is a competence in logic called "association." Such competence is exercised from the relationship of different types of information in search of an adequate conclusion. It is enough for the observer to understand the contexts in which the information is placed.

Consider, for example, that all students in a medical course passed the anatomy discipline. However, only some students passed the chemistry discipline. To progress to the next grade, it is necessary for all students to pass all disciplines. By associating the information, you can conclude that not all medical course students progressed to the next grade.

See that the mechanisms of developing logical reasoning are simple and often depend on the interpretation of the person facing the context. Usually, even cases that include mathematical operations are basic if the observer follows a constructive line of reasoning, that is, adding the elements part by part.

An important tip for exercising association is to find the key elements of the contexts in which they are presented, in addition to strategic words such as "some," "all," "none." After identifying the terms, try to associate small parts until reaching the whole, which is the conclusion of the question or situation.

See that the correlation structure works very well for the development of associative thinking. Therefore, consider that the study of this logical competence is fundamental for various situations, including considering the other categories of logical reasoning that work with much information.

Synthesis

Consider the concept of synthesis as being an abbreviation or a succinct conclusion of a cluster of information. Now, try to reflect on how synthesis can be associated with logical reasoning.

Synthesis consists of interpreting and associating different ideas to generate a conclusion. This means that it is necessary to develop the competence of analyzing the elements in question and organizing them in a simplified way at the end.

In reality, the process works as a kind of "filter" to obtain this conclusion.

In a practical way, just consider a context of various information that needs to be summarized in a homogeneous and clear way. For example, you and your family are planning a trip for the holidays. Part of the family prefers the beach, and the other does not give up on a shopping mall. Before choosing the location, consider that one of the members can only travel on weekends.

In a synthetic way, consider key points of the situation: it is necessary for everyone to travel together, meeting the seasonality requirement (weekend) and particular situations, such as the existence of the shopping mall and the preference for the beach.

The most synthetic conclusion you can reach is to plan a trip to a large beach city on a weekend. Thus, everyone can be attended to, despite their particularities.

An important tip for developing synthetic reasoning is to consider the macro context in which a certain situation is presented. In the previous example, it would be the context of the family trip. Then, it will be necessary to gather the particularities and find a solution that covers all the necessary key points.

Note that it is not a situation of errors or hits, but rather of better adequacy to the context. Therefore, consider that the competence of synthesis will be developed when diverse information needs to be summarized according to a common denominator.

Consistency: The Key to Improvement

Darlan Jr — Sun, 02 Feb 2025 05:31:27 +0000

Consistency: You can only improve at something by being consistent. Every day, you try again, and that's the only way you'll get better.

Testing things is good for figuring out what you're not good at.

Energy is not infinite. Thinking logically, by the end of the day, you'll be more tired. Set your priorities for the morning.

You're studying, then you stop to check your phone, and then you go back to studying. You feel like you're not making the most of it. Of course, you're not going to make the most of it.

Example:

Energy = 10 points

1st Case -> Spend all 10 points on studying.

2nd Case -> Spend 6 points on studying and 4 on your phone.

Considering two identical people, who will know more?

It's very obvious that if you split your points with your phone, you'll know less and you'll be wasting your time. The same goes for gaming.

Task

Do one thing at a time. Focus on a single task.

A great example of giving your best:

Gym: If I keep taking my phone to the gym and splitting my focus with WhatsApp and other apps, I'm not giving my best. If I'm not giving my best, I'll need more time to improve my body.

The Benefit of Focus

The more focus I have, the faster I'll get better.

Focus brings speed.

Every time you catch yourself losing focus and going to TikTok, Instagram, or similar apps, remember that you're delaying how good you can become. You're adding 5 more days to learn a simple task.

We all know there are multiple paths to achieve things.

I want to get rich -> There are many paths and ways for that to happen.

How to Improve Your Life?

You need to follow through with things until the end.

What can't happen is constantly changing paths. Draw a path and stick to that plan.

The best opportunity is the one you see through to the end.

Sometimes you say a certain project didn't work out, but did you actually go all the way?

It's no use jumping from one thing to another. You need to choose your area and focus.

Choose one thing and make that thing work.

FOCUS and Go All the Way

[Boost]

Darlan Jr — Sat, 01 Feb 2025 07:06:27 +0000

A Modern Node.js + TypeScript Setup for 2025 🚀

Sibelius Seraphini for Woovi ・ Jan 29

#node #ts #simple