EvadeMe

An asynchronous heuristics evasion library for Android with a KTX scoping function.

User Instructions

Add the maven repository to your project's build.gradle file

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Add the dependency to your app's build.gradle file

dependencies {
    implementation 'com.github.evilthreads669966:evademe:2.1'
}

Use the evade ktx function inside of any android context.

//by default assumes you require networking inside of trailing lambda
evade {
    Log.d("EVADE", "EVIL THREADS");
}.onEscape{
    Toast.makeText(this, "We evaded with networking", Toast.LENGTH_LONG).show()
}.onSuccess {
    Toast.makeText(this, "We executed the payload with networking", Toast.LENGTH_LONG).show()
}

//maby you don't require any networking for your payload inside of trailing lambda
evade(requiresNetworking = false) {
    Log.d("EVADE", "EVIL THREADS");
}

Important To Know

evade is a suspension function
any code inside of the evade scoping function is safe from analysis.
evade is a KTX function with a receiver of type context
evade by default assumes that your are passing a function that uses internet
- If you have a payload that does not require internet then you can pass false to requiresNetworking optional parameter
  - Passing in false to evade allows to skip evasion checks that are related to network analysis

Ask a Question?

Use Github issues
Send an email to evilthreads669966@gmail.com

Reporting issues

Found a bug on a specific feature? Open an issue on Github issues

Contributing

SMS Backdoor is released under the Apache 2.0 license. If you would like to contribute something, or simply want to hack then this document should help you get started.

Code of Conduct

Please refrain from using any profanity
Please be respectful on GitHub Issues
Have fun

Pull Requests

Please create a branch prefixed with what you're working on.
- FEATURE_ADDING_SOMETHING
- BUG_FIXING_SOMETHING
- REFACTOR_CHANGING_SOMETHING
Once you're done with your commits to this branch hit a pull request off and I'll look at it and most likely accept it if it looks good.

Using GitHub Issues

We use GitHub issues to track bugs and enhancements.

If you find a bug please fill out an issue report. Provide as much information as possible.
If you think of a great idea please fill out an issue as a proposal for your idea.

Code Conventions

None of these is essential for a pull request, but they will all help. They can also be added after the original pull request but before a merge.

We use idiomatic kotlin conventions
Add yourself as an @author to the .kt files that you modify or create.
Add some comments
A few unit tests would help a lot as well -- someone has to do it.
If you are able to provide a unit test then do.
- Because of the types of libraries I develop often times it is hard to test.

Working with the code

If you don't have an IDE preference we would recommend that you use Android Studio

Contributors

This project exists thanks to all the people who contribute.

Talking about EvadeMe

Articles

Android Heuristic Evasion

License

Copyright 2020 Chris Basinger

   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.

JohnFrontzos/EvadeMe